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INTRODUCTION 


The productivity of a computer facility is largely dependent on an operator’s experience and knowledge 
of the system. When the programs produced for the installation have been refined and are ready for use, 
the results obtained are largely due to the expertise of the operator. Therefore, some concept of the 
: MCP and a knowledge of the peripherals used with the B 1700 Systems are important in order to 
utilize the equipment effectively. 


This manual is divided into sections to ease the operating personnel’s task in referencing material to effi- 
ciently operate the B 1700 system. 


The purpose of the B 1700 Systems System Software Operational Guide is to provide a general 


description of all Burroughs B 1700 System Software without going into such detail as is required for 
a programming language or a reference manual. Formal documents pertaining to the system software 
described herein are referenced where applicable. Included in this manual are those operating instruc- 
tions required to perform any major function of the described system software. 


An explanation of the notational conventions used throughout this manual is as follows: 


a. Key Words. All underlined upper case words are key words and are required when the functions 
of which they are a part are utilized. 


b. Optional Words. All upper case words not underlined are optional words, included for readability 
only, and may be included or excluded as desired. 


_ 


c. Lower Case Words. Ali lower case words represent generic terms which must be supplied in the 
position described. 


file-identifier | 


penne nn te 


d. Braces. Words or phrases enclosed in braces ({ } ) indicate a choice of entries of which one must 
be made. 


Hgneurs 


e. Brackets. Words or phrases enclosed in brackets ([ }]) represent optional portions of a statement 
which may be omitted. 
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f. Consecutive Periods (Ellipsis). The presence of ellipsis (...) within any format indicates that the 
control syntax immediately preceding the ellipsis notation may be successively repeated, depend- 
ing upon the requirements of the operation. 


| [control-attributes] ... 


g. Question Mark. The appearance of a question mark (?) indicates that any invalid EBCDIC 
character or the question mark itself is acceptable. This convention is used primarily by the 
Master Control Program to indicate a control card instruction. 


| [?] LOAD 


h. At Sign: Any data contained between “at signs” @ identifies that information to be hexadecimal 


information. 
| @0CF3@ | 
i. Integer: The presence of the word integer within any format signifies that the data to be 


expressed may be decimal, octal, hexadecimal, or binary. 


decimal — any valid decimal character or characters. 
452 
hexadecimal — any valid hexadecimal character or characters ae within @ 
signs. 
@A22F@ 4 
octal — any valid octal character or characters enclosed within @ signs and 


preceded by the MODE indicator (3). The MODE indicator must 
be enclosed by parentheses. 


@ (3)036@ | 


binary — any valid binary character or characters enclosed within @ signs 
and preceded by the MODE indicator (1). The MODE indicator 
must be enclosed by parentheses. 


@(1) 1101001@ 7 


j. Master Control Program: The Master Control Program is abbreviated throughout this manual as 
MCP. Its functions are explained in a separate section of this manual. 
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SECTION | 
INTRODUCTION TO SYSTEM 


SYSTEM INITIALIZATION 


The MCP was designed as an integral part of the system and is intended to serve a wide range of installations 
and users. Therefore, provisions have been incorporated in the system to adapt the operation of the MCP 
to the particular requirements of a variety of installations. This has been accomplished by incorporating 
different environments within the MCP which may be specified at the time of system initialization. Some 
of the environment options can be changed or set after the system has been initialized by using a console 
printer input message. 


In order to place the MCP in control of the system, the MCP must be loaded onto the system disk with the 
system’s environment defined and the disk directory established. Then the SDL interpreter must be loaded 
to interpret the MCP S-language. When this procedure has been completed, the SDL interpreter starts 
interpreting and executing the instructions of the MCP. 


Three separate procedures are performed during initialization thereby making the system operable: 
(1) Initializing Disks (System and Removable), (2) Performing a COLDSTART, and (3) Performing a 
Clear/Start. 


UNIT MNEMONICS 


Mnemonic names are assigned to the peripherals attached to the system by the MCP. The mnemonics are: 


CDx Card Reader/Punch 
CPx ‘Card Punch 

CRx Card Reader 

CSx Magnetic Tape Cassette 
DCx Disk Cartridge 

DKx Head-per-Track Disk 
DPx Disk Pack 


LPx Line Printer 

MTx Magnetic Tape 
PPx Paper Tape Punch 
PRx Paper Tape Reader 


SPO Console Printer 
SRx MICR Reader-Sorter 


NOTE 


The “‘x”’ is replaced by a capital letter, A - Z, for multiple 
units of a specified type. 


SYSTEM DESCRIPTION 
The following functions are controlled by the MCP: 
a. Loading 
b. Interrupt handling 
c. I/Ocontrol 
d. Selection and initiation of programs 


e.  I/Oerror handling 
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f. System log maintenance 
g. Storage allocation-—memory and disk 
h. Overlay functions—-data and code 
i. Multiprogramming 
Both the MCP I and MCP II will service the following standard peripheral equipment: 
a. Console Printer 
b. 96-column Card Devices 
c. 80-column Card Devices 
d. Line Printers 
e. Disk Cartridges 
f. Magnetic Tape Cassette 
In addition, MCP II will accommodate the following peripherals: 
a. Disk Pack. 
b. Single Line Control and Multi-Line Control for Data Comm. 
c. Head-per-Track Disk. 
d. Magnetic Tape. 
e. MICR Reader-Sorter. 
f. Paper Tape Devices. 
HARDWARE REQUIREMENTS 


The following list of equipment must be present for MCP operations. However, the listed equipment is 
not dedicated to the MCP and may be utilized by any user program. 


Hardware Type Usage 

Console Printer Operator communication 
Disk Auxiliary storage 

Card Reader Control input 


CENTRAL SERVICE MODULE 


The Central Service Module (CSM) is a microcoded routine which performs the following functions in an 
equivalent hard-wired machine: 


a. Interrupt Detection and Handling. 


b. Passes control to/from the MCP, usually on an interrupt. 


c. Controls all I/O activity, such as: 
1. I/O Initialization 
2. Data Transfers 
3. I/O Termination 
d. Manages Interpreter Activity. 
INTERPRETERS 


Interpreters are microcoded routines, or “firmware,” that perform the operations specified by the 
programmer. Each language has its own interpreter. 


SECTION 2 
MASTER CONTROL PROGRAM 
GENERAL 


The Master Control Program (MCP) is a modular operating system which assumes complex and 
repetitive functions to make programming and operations efficient and productive. The MCP provides 
the coordination and processing control that is so important to system throughput by allowing maxi- 
mum use of all system components. Operator intervention is greatly reduced through complete 
resource management. Since all program functions are performed under this centralized control, 
changes in scheduling, system configuration, and program size can be readily accommodated resulting in 
greater system throughput. 


The B 1700 System Software Operational Guide will make reference to both MCP I and MCP II, distin- 
guishing between the functions of each where applicable. The basic difference between MCP I and MCP II 
is that MCP I is designed for minimum system configurations and does not have multiprogramming 
capabilities whereas MCP II is designed for larger system configurations with multiprogramming capabilities. 


A detailed description of the MCP is presented in the B 1700 Master Control Program Reference Manual. 
MCP DISK STRUCTURES 


A significant aspect of the MCP design is the disk handling technique. Because this handling is the respon- 
sibility of the MCP, programs are less complicated and easier to write. 


Areas handled by the MCP include: 


a. Directory Maintenance 


Users need only to specify LOAD, DUMP, ADD, UNLOAD, CHANGE, or REMOVE directives 
by file-name. All other actions pertaining to disk table maintenance are automatic. 


b. Disk Allocation 


Programs need only specify the amount of disk space they require. The MCP will handle the 
actual allocation of a physical area containing only the amount requested. 


c. File Assignment 
As for all files within the system, disk file assignment is made according to the programmatically 
specified file name and type. 


d. Record Addressing 
Programs need only specify the accessing method, and in the case of random files the specific 
record desired. The actual disk location is the sole responsibility of the MCP. This means the 
programmer need not be concerned with the physical locations of the files. 


e. Paging 
Paging is the technique by which the programmer may divide a disk data file into portions which 
may occupy non-contiguous areas of disk, rather than one huge area. Areas need not even be 
allocated until actually needed, thus decreasing the need for disk space until required by the size 
of the file. 


DISK DIRECTORY 


The Disk Directory is a disk-resident table that contains the name and type of file, together with a pointer 
to the disk file header or sub-directory for all files on which the MCP received a permanent disk directory 
entry request. 


2-1 


Disk-Pack-Identifier 
The disk-pack-id is the name that is assigned to a user disk pack or cartridge at initialization time. 
Example: 
AAA/program-name/ 
AAA is the disk-pack-id 
Main Directory File Name 


If there were a set of programs that were all common to solving one problem, they could all have the same 
first “‘family” name. The disk pack-id is not used to access a system disk. 


Example: 
PAYROLL/program-name-1 
PAYROLL/program-name-2 
PAYROLL/program-name-3 
PAY ROLL/program-name-4 


In this example, PAYROLL is the main directory file name or the family name, while program-name-1 
through program-name-4 are the sub-directory file names. 


Sub-Directory File Name 
The main directory links to a sub-directory when the sub-directory file-id is used. This sub-directory will 
contain an address on disk of a File Header for each of the sub-directory file entries. The sub-directory is 
an extension of the main directory. 
Main Directory Contents 
The main directory entry contains: 
1. Family Name 
2. Address of the disk file header or sub-directory. 
3. Type of File: 
1= LOG 
2 = Directory (entry points to sub-directory ) 
3 = Control Deck 


4 = Backup Print 
5 = Backup Punch 


6 = Dump File 
7 = Interpreter 
8 = Code File 
9 = Data File 


Sub-Directory Contents 


If the file has a family name and a secondary file name, the address in the main directory does not point to 
the disk file header but to a sub-directory. This sub-directory has the same format as the main directory, 
except that it uses only one segment of disk for each eleven file names. If there are more than eleven names 
in the sub-directory the MCP increases the size by cne segment for each eleven additional names. 


The sub-directory entry is identical to the main directory entry with the exception that the address always 
point to a Disk File Header. 


Directory Reference 


When a file is referenced on a removable disk, it must be preceded with the disk-pack-lid. The removable 
disk directories and system disk directories are the same format. 


MULTIPLE PACK FILES 
Introduction 


A multiple pack file is a file that can be contained on one or more removable disk packs ¢cartridges). The 
file attribute MULTI.PACK of the FILE statement may be used to declare a file to be a multiple pack file. 


Abbreviations 


MPF — Multiple Pack Files 
BP — Base Pack 
CP -— Continuation Pack 


Restrictions 


There are some restrictions imposed on multiple pack files that limit their selection for usage. They are as 
follows: 


a. The maximum number of packs that can be assigned to a multiple pack file is 16, consisting of 
one base pack and 15 continuation packs. 


b. There must be a minimum of two (2) disk drives present on the system (one system pack and one 
removable pack). 


c. Only removable disk packs can be used for multiple pack files. A system pack cannot be used for 
a multiple pack file. 


d. All packs containing a multiple pack file must have unique serial numbers. The disk pack-id is 
not the primary identifier for continuation packs. 


NOTE: 
It is suggested that all packs be initialized with unique serial numbers. 


Base Packs 


A multiple pack file can have only one base pack. The base pack must be on-line for any open or close 
operation performed on the file. It can be required at other times depending on the action requested by 
the program; if so, a message is printed on the console printer requesting the operator to mount the base 
pack if it is not on-line. A base pack can contain both single and multiple pack files; however, it cannot 
contain continuation files. 


The header on the base pack retains all information concerning the file including the address of every area 
assigned to that file. For each area resident on a continuation pack, the base pack contains the serial num- 
ber of the continuation pack. This allows the MCP using the base pack to control all processing, and thereby 
avoid updating each continuation pack as the file is processed. 

Continuation Packs 


When data overflows or “‘continues”’ to additional disk packs, the term Continuation Pack (CP) is used. 
There can be up to a maximum of 15 continuation packs for one multiple pack file, but a continuation 
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pack can be associated with only one base pack. A continuation pack can only contain continuation files, a 
and all continuation files contained on a continuation pack must be assigned to the same base pack. A CP 
cannot contain single pack files, and cannot itself be a base pack. 


When space is needed for a multiple pack file, the MCP searches for another continuation pack that is asso- 
ciated with the same base pack. Ifa continuation pack is not present on the system, the MCP then searches 
for a scratch pack (one that has just been initialized or purged and is of the same type, restricted or unrestric- 
ted, as the base pack). If such a pack is found, the scratch pack is automatically assigned to the multiple 
pack file. 


General Information 


DISK/COPY cannot be used to copy multiple pack files. Multiple pack files can be sorted (INPLACE 
sort only). 


To obtain the maximum disk space available for a multiple pack file, assign 105 as the number of areas 
required and increase the BLOCKS.AREA. 


Random files are allowed for multiple pack files. 
A system pack cannot be used as a base or continuation pack. 


The CHANGE (CH) message is not allowed on a multiple pack file; however, a REMOVE (RE) message is 
permissible. 


An interrogation is performed by the MCP prior to opening a multiple pack file to predict whether a dupli- 
cate file situation exists. If so, the operator has the option of either removing the existing file at that time 
or waiting until file close time to remove the duplicate file, and using the OK console message. 


A DS console message performs a normal close on a multiple pack file. 


A base pack does not necessarily have to have any of its data residing on it. As soon as the file is opened 
and the tables built, the base pack can be removed or be off-line. 


A scratch pack is one that has either been just initialized or purged. A pack which has had all files removed 
is not a scratch pack. 


HALTS 
When certain conditions of the MCP have been violated, all processing may stop and a HEX value will be 
displayed in the “‘L” register. Recovering from a HALT state may usually be accomplished by performing 


a Clear/Start. The following list will explain the HALT codes and their meanings. 


Halt Code Description of Halt 


Evaluation/Program Pointer Stack overflow. 
Control Stack overflow. 

Name/Value Stack overflow. 

Remaps size error. 

Invalid parameter passed to a procedure. 

Invalid substring. 

Invalid subscript. 

Invalid data type value returned from a procedure. 
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Invalid case. 


Halt Code 


10 


11 


12 


MCP OPTIONS 


Description of Halt 
Divide by zero. 
Invalid index. 
Memory parity. The “T’’ register will contain the 
address of the parity error. If the ““T’’ register equals 


@FFFFFF@, the error was caused by an attempt to read 
outside the physical bounds of memory. 


Invalid operator. 

Console HALT. (INTERRUPT switch) To continue 
processing turn INTERRUPT switch off and press 
START. 


This is a controlled HALT. The “T”’ register will contain 
a description of the halt as follows: 


T REG DESCRIPTION 
TA2 @C@ ........ Result Descriptor with Exception 
Bits Set. 
‘ALL OTHERS...... First Six Characters of MCP 


Source Sequence Number (Submit 
Memory Dump and Trouble 
Report). 


Attempt to write outside of the MCP base or limit register. 


The MCP will perform certain functions based on the settings of various options. The system operator can 
use the SO input message to set an option, or the RO message to reset an option, except in the case of the 
LOG option which is independently set with the SL message. 


At COLDSTART all of the MCP options with the exception of DATE, TIME, DUMP, BOJ, and EOJ are 
reset and must be set if desired as part of the MCP’s operations. 


The DATE and TIME options are set automatically at COLD START time. The date and time must be 
entered after Clear/Start before the MCP will allow programs to execute. However, these options may be 
reset, thereby making it unnecessary to enter the date and time after each Clear/Start. After a Clear/Start, 
the MCP options remain in the same state, set or reset, as they were before the Clear/Start was performed. 


The following is a list of the available MCP options: 


BOJ DUMP MEM RMOV ZIP 
CHRG EOJ OPEN SCHM 

CLOS LAB PBD TERM 

DATE LIB PBT TIME 

DBM LOG PWS TRMD 


The MCP options are defined in the following paragraphs. 
BOJ 


The BOJ option specifies that a Beginning-of-Job message be displayed each time the MCP initiates an 
executable object program. 


CHRG 


The CHRG option requires that all program executions be accompanied by a charge number which will be 
entered in the log. 


CLOS 


The CLOS option specifies that a “‘file-id CLOSED . . .”” message be displayed each time an object program 
closes a file. 


DATE 


The DATE option is set at COLDSTART and specifies that the ““**DR PLEASE” message be displayed at 
Clear/Start. When the ‘“** DR PLEASE” message is displayed, the system operator must enter the date 
with the DR input message before program execution may begin. 


DBM 


The DBM (Data Base Management) option pulls into memory an overlay disk segment containing a search 
Operator to be bound into the CSM for disk search at Clear/Start time. The DBM option must be set to 
cause the presence of the overlay and must be used for Data Base Management, or when a RPG program 
uses the Index Sequential filing technique. A Clear/Start is required by the MCP after the option is set or 
reset. 


DUMP 


The DUMP option must be set in order to dump memory. If the DUMP option is reset, SYSTEM/ 
DUMPFILE will be removed from disk and the space made available to the system. Any attempt to dump 
system memory (not DM or DP) will be ignored if the DUMP option is reset. 


EOJ 


The EOJ option specifies that an End-of-Job message be displayed each time an object program reaches 
normal End-of-Job. 


LAB 


The LAB option causes the MCP to display a tape label-name when a BOT (Beginning-of-Tape) is sensed. 
The character set for a Train Printer will also be displayed. 


LIB 


The LIB option causes the MCP to display library maintenance actions performed on disk files. The 
message displayed on the console printer can be one of the following: 


file-identifier REMOVED 

file-identifier CHANGED TO file-identifier 
file-identifier LOADED 

file-identifier DUMPED 


LOG 


The LOG option will request the MCP to keep a log of all program executions on disk. See the LG, SL, 
and TL input messages for actions pertaining to the LOG. 


MEM 


When reset, the MEM option will inhibit any messages from being displayed by the MCP regarding 
insufficient memory conditions. 


OPEN 


The OPEN option specifies that a ‘‘file-identifier OPENED .. .”” message be displayed each time an object 
program opens a file. 


PBD 


The PBD option specifies that output files assigned to a printer or card punch will be diverted to a disk 
backup file if the required output device is not available when the object program tries to open that file. 


PBT 
The PBT option specifies that output files assigned to a printer or card punch will be diverted to a tape 
backup file if the required output device is not available when the object program tries to open that file. 
NOTE 

If both the PBD and the PBT options are set, backup will 

go to tape if a unit is available; if not, the backup will go 

to disk. 
PWS (MCPI only) 
The PWS (Program Working Set) option allows the MCP to minimize the amount of memory it has to swap 
when going from the user program to the MCP and back again. The PWS option will only benefit a system 
with 32 K or greater. The working set of a program is defined to be those code segments needed in memory 
to run the program efficiently. 


RMOV 


The RMOV option if set will automatically remove the old file in ““DUPLICATE FILE ON DISK” 
situations as though an RM message had been typed in by the system operator. 
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SCHM 


The SCHM option causes the MCP to display a message when a program is placed in the schedule. The 
message has the following format: 


job-number program-name NEEDS integer KB, SCHED PR = schedule-priority, 
IN FOR hh:mm:ss.t, number-of-levels DEEP IN ACTIVE SCHEDULE 


TERM 

The TERM option specifies that the MCP automatically discontinue processing (DS) of a program when an 
error condition is encountered. If an error condition occurs and it is necessary to obtain a memory dump 
of the program, the TERM option should be reset, or the TRMD option should be set. 

TIME 

The TIME option is set at COLDSTART and specifies that the “**TR PLEASE” message be displayed at 
Clear/Start. When the ““**TR PLEASE” message is displayed, the system operator must enter the time 
with the TR input message before program execution may begin. 

TRMD 

The TRMD option specifies that the MCP automatically dump memory and discontinue processing (DP) a 
program when an error condition is encountered. If both TERM and TRMD are set, the TRMD option 
takes precedence. 


ZIP 


The ZIP option when set will display on the console printer all programmatic ZIP statements made to 
the MCP. 


MCP-OPERATOR INTERFACE 
Control Instructions 


The Master Control Program is directed to perform particular actions by the system operator through the 
use of control instructions. These control instructions apply to both the MCP I and the MCP II. 


Control instructions may be supplied to the Master Control Program by punched cards, the console printer, 
or programmatically through the usage of ZIP statements in an executing program. 


There are five major types of control instructions: 
a. Library Maintenance Instructions 
b. Program Control Instructions 
c. Program Control Instruction Attributes 
d. File Parameter Instructions 


e. System Control Instructions 


The following rules apply to all control instructions supplied to the MCP: 


a. Ifthe special character percent (%) appears in a control instruction, all information following 
the % is ignored for control purposes. This allows comments to be present on control cards. 


b. The appearance of the “less than” (<) sign in a control message causes the MCP to backspace its 
pointer one position for each < sign while scanning the control instruction. This allows correc- 
tion of mistakes without requiring that the entire message be re-entered. Even though this 
technique is intended mainly for messages entered from the console printer, it works with con- 
trol instructions entered on punched cards as well. This use of the “less than”’ sign does not 
work with control instructions entered through ZIP statements. The “‘less than’’ sign may not 
be used for any other purpose. 


c. Any program-name or file-identifier which contains the special characters listed below must be 
enclosed in quotes. 


‘ semicolon 

) comma 

= equal size 

/ slash 

blank or space 
quote mark 

@  atsign 

% percent sign 


ce 


Any special characters not contained in the above list do not require quote marks to enclose the 
identifier. The < sign may not appear in an identifier. 


Examples: 


“FILE%001” 

%3” |“%ABC=” 

“IXYZ” 
SDL.INTRIN/#000000001 


The slash in the second example above separates the family-name from the file-name and is not 
enclosed in quotes. 


In the third example, the slash is part of the family-name and is, therefore, enclosed in quote 
marks. 


In the last example the pound sign (#) is not listed as a special character, so the identifier need 
not be enclosed with quote marks. 


d. All control instructions are described on the following pages under headings which might indicate 
that each of them must consist of a separate card. This is not necessarily so; if the text of one 
control instruction is delimited by a space then this is considered the “‘logical end”’ of that 
control instruction. 


Sources of Control Instructions 
If punched cards are used to communicate a control instruction to the MCP, the following rules apply: 

a. Column 1 of the first control card must contain an invalid character (80-column cards) or a 
question mark (96-column cards). An invalid character or question mark cannot appear in any 
other column. The next 71 columns of the card can contain control instructions in free-field 
format. Control information is limited to the first 72 columns of the control card. 

ba ed 

b. Control instructions can be contained on more than one card; however, control words cannot be 
split and continued to another card. The invalid character in column one is optional on continu- 
ation cards. 

CONSOLE PRINTER 

Control instructions may be communicated to the MCP from the console printer by the following procedure: 
a. Press the INPUT REQUEST button on the console printer. 
b. Wait for the READY indicator to light. 


c. Enter the control instruction from the console printer. If more than one line is required, proceed 
to step d; otherwise, proceed to step e. 


d. If more than one line is required for the message: 
1. Press the LINE FEED button. 
2. Press the CARRIAGE RETURN button. 


3. Press the END OF MESSAGE button. 


4. Return to step b. g 


e. Press the END OF MESSAGE button. 
If there are errors that cannot be corrected by using jn ee ign, press the ERROR button on the 


console printer. The entire message (including all lines Ofmrekttpié-line messages) are discarded by the MCP; 
an exclamation point (!) is typed to aid in identification, and the READY indicator relights. The message 
can then be re-entered. 


Messages entered from the console printer are subject to the following rules: 


a. The “less than” sign will not correct any message entered prior to the current line. Errors in 
previous lines of multiple-line input messages cannot be corrected by using the “‘less than’”’ sign. 

b. A blank is implied at the end of each line when multiple-line messages are entered; therefore, 
words may not be split between lines on the console printer. 


ZIP 


Control instructions can be communicated to the MCP by the use of a ZIP statement in an executing pro- 
gram. The ZIP statement in the program must reference a defined data area where the control statement is 
located. Refer to the appropriate language reference manual for specific syntax regarding the ZIP statement. 
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Generic Terms 


A number of generic terms are used within this manual to describe the syntax of input and output messages. 
These terms are defined as follows: 


a. identifier: A word consisting of from one to ten alphabetic, numeric, or special characters in 
any combination. 


b.  disk-pack-id (dp-id): An identifier which is the name of a disk pack or cartridge. 


c. family—name: An identifier which is a file name, or the name given to identify a main file with 
sub-directory entries. 


d. program—name: A file-identifier which is the name of a program. 
e. compiler—name: A file-identifier which is the name of a compiler. 
f. interpreter—name: A file-identifier which is the name of an interpreter. 


g. unit—mnemonic: A name which consists of from one to six characters, used to identify a 
peripheral device. 


unit—mnemonic Device 
CDx Card Reader/Punch 
CPx Card Punch 
CRx Card Reader 
CSx Magnetic Tape Cassette 
DCx Disk Cartridge 
DKx Head-per-Track Disk 
CPx Disk Pack 
LPx Line Printer 
MTx Magnetic Tape 
PPx Paper Tape Punch 
PRx Paper Tape Reader 
SPO Console Printer 
SRx MICR Reader-Sorter 


The “x” notation represents an alpha character which-distinguishes multiple units of the same 
type. For example two Line Printers would have mnemonic names of LPA and LPB. 


h. system disk: A disk pack or cartridge that is initialized as a system type pack. A system pack is 
under the control of the MCP and one or more must be present on the system for the MCP to 
function. Head-per-track disk is always considered system disk. 


i. removable disk: A disk pack or cartridge that can be removed from the system during operations. 
The MCP does not need removable disk packs in order to function. 


i file—identifier: All disk-file-identifiers used on the system must be unique, therefore, there can 
be no duplication of file names. Throughout this manual “‘file—identifier’’ will incorporate all 
the combinations allowed for a file—identifier, such as the following: 


file—identifier 
family—name/file—identifier 
dp—id/family—name/file—identifier 
dp—id/file—identifier/ 
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| CHANGE | 


LIBRARY MAINTENANCE INSTRUCTIONS 
CHANGE 


The CHANGE statement changes the file-identifier of a disk file, causing the file to be referenced by the new 
file identifier. 


The format of a CHANGE statement is: 


[2] oe file-identifier-1 TO file-identifier-2 [, file-identifier-3 TO file-identifier-4] . . . ; 


The control word CHANGE may be abbreviated as CH. 

Any CHANGE statements affecting more than one file must have the file-identifiers separated by commas. 
The CHANGE statement will cause the MCP to change the file-identifier of specified disk files from one 
name to another. If the file referenced in the CHANGE statement resides on a removable disk, the disk- 
pack-id must precede the file-identifier in order for the MCP to locate the proper file to change. 


? CHANGE ALPHA/BETAONE/ TO ALPHA/BETATWO/ 


If the CHANGE statement is entered and the MCP cannot locate the file or if the file is in use, the 
following message is displayed on the console printer: 


file-identifier NOTCHANGED ... (reason)... 
The CHANGE statement is not allowed on a Multi-Pack File. 


The CHANGE statement may consist of additional cards where two or more “‘changes” may be made. For 
example: 


? CHANGE 
? A/B C/D, 
7X Y,ZQ, 
? ABC DEF; 


Termination will occur when a semicolon (;) is detected. 
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ADD 
LOAD 


The ADD statement will cause a file or files on a LIBRARY tape to be placed on disk only if the file is not 
already on disk. 


ADD, LOAD 


The LOAD statement will cause a file or files on a LIBRARY tape to be placed on disk. If the file is already | 
on disk, the old file will be removed. 


The format of the ADD and LOAD statement is: 


[TO disk-pack-identifier ] 


S= 
FROM library-tape-identifier file-identifier file-identifier 
family-name/= Ls family-name/= = 
=/file-id =/file-id 


The control words ADD and LOAD nay be abbreviated as AD and LO, respectively. 

The =/= option causes every file on the tape to be added or loaded. 

The family-name/= option causes every file with the specified family-name to be added or loaded. 
The =/file-id option causes every file with the specified file-id to be added or loaded. 

Examples: 


?LOAD FROM SYSTEM COBOL, 
?RPG, BASIC; 


?ADD TO USERPACK FROM LIBTAPE 
PAYROLL/= 
ACCPAY/=, 
MASTER/FILE, 
=/REGISTER; 
_ 2?LOAD FROM LIBRARY =/=; 
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DUMP 
UNLOAD 
DUMP, UNLOAD 


The DUMP statement causes one or more disk files to be placed on a LIBRARY tape. The file is not 
removed from disk by the dump. 


The UNLOAD statement causes one or more disk files to be placed on a LIBRARY tape. The disk file is 
removed after the successful completion of the UNLOAD. 


The format of the DUMP and UNLOAD statement is: 


[FROM disk-pack-identifier ] 


t 
wT 


TO library-tape-identifier file-identifier file-identifier 


family-name/= * | family-name/= 


The control words DUMP and UNLOAD may be abbreviated as DU and UN, respectively. 
The =/= option indicates that all files on the specified disk are to be dumped or unloaded. 
A maximum of 2248 files can be handled with one DUMP or UNLOAD statement. 
Examples: 

?7DUMP TO SYSTEM 

Z/Q, 

AAA,COBOL/=, 


RPG/REORG, 
SDL.INTRIN/= 


? 


2?UNLOAD FROM USER TO BACKUP =/=; 
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REMOVE 


REMOVE 


The REMOVE statement deletes specified files from the disk directory making the file space available to 
the MCP. 


The format of the REMOVE statement is: 


file-identifier 
| REMOVE 
—— family-name/= [, ...] 


RE dp-id/family-name/= ae = 


[?] 


The control statement REMOVE may be abbreviated as RE. 
The ‘‘/=”’ form will delete the main directory entry and in turn delete all the files in its sub-directory. 


The REMOVE statement may delete any number of files. However, any statement affecting more than 
one file must have the file-identifiers separated by commas. 


If the file-identifier referenced in the REMOVE statement resides on a removable disk pack, the disk-pack- 
id must precede the file-identifier in order for the MCP to locate the correct file. When the disk-pack-id 

is not included, the MCP assumes that the file resides on a system pack. 

Once a file has been removed, there is no means of recovering it. 


The REMOVE statement may be continued to additional cards with the last “‘remove”’ terminated by a 
semicolon. 


Example: 
? REMOVE A/B 


b) ) Y, 
Z; 
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COMPILE 


PROGRAM CONTROL INSTRUCTIONS 
COMPILE 
The COMPILE statement designates the compiler to be used, and the type of compilation to be performed. 


The format of the COMPILE statement is: 


LIBRARY 
TO | 
COMPILE SYNTAX 
[7] | a | program-name WITH compiler-name ee | Sy. 
pec FO pr 
; SAVE 
[control-attributes] ... SA 


The COMPILE statement may be abbreviated as CO. 


The compiler control statement must be the first statement in a set of control statements. The COMPILE 
statement has four options: 


1. COMPILE 

2. COMPILE TO LIBRARY 
3. COMPILE SAVE 

4. COMPILE FOR SYNTAX 


The COMPILE is a ‘‘compile and go” operation. Providing the compilation is error-free, the MCP 
schedules the object program for execution. The program will not be entered into the disk directory, and 
must be recompiled to be used again. The “compile and go” is the default option of the COMPILE 
statement. 


The COMPILE TO LIBRARY will leave the program object file on disk and will enter the program-name 
into the disk directory after an error-free compilation. The program is not scheduled for execution. 


The COMPILE and SAVE combines the execute and library options. The MCP will enter the program- 
name into the disk directory and will leave the object program file on disk, as well as schedule the program 
for execution after an error-free compilation. The program remains in the disk directory. 


The COMPILE FOR SYNTAX provides a diagnostic listing as the only output. This option does not enter 


the program-name into the disk directory or leave the program object file on disk. Some uses are as a 
debugging tool, first time compilation, or a new source listing. 
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DYNAMIC 


DYNAMIC 


The DYNAMIC statement will modify the working copy of a program that is already in the mix or 
scheduled for execution. 


The format of the DYNAMIC statement is: 


DYNAMIC 
[?] 


job-number  [control-attributes] ... 
DY 


The DYNAMIC control word may be abbreviated as DY. 


Any change that can be made by using the MODIFY statement is valid for the DYNAMIC statement; 
however, only the working copy of the program will be altered. 
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EXECUTE 


EXECUTE 


The EXECUTE statement instructs the MCP to call a program from the library for subsequent 
execution. 


The format of the EXECUTE statement is: 


EXECUTE 
[?] 


EX program-name [control-attributes] ... 


The EXECUTE control word may be abbreviated as EX. 


The EXECUTE control statement must be the first statement in a set of control statements pertaining to 
the execution of a program. 


If the program referenced in the EXECUTE statement resides on a removable disk cartridge or disk pack, 
the disk-pack-id must be part of the program-name in order for the MCP to locate the correct file. 


Example: 


? EXECUTE TEST 

? DATA file-identifier 
(data cards) 

? END 


This example shows that a program named TEST is to be called out of the library on disk and 
executed. One of the files in the program TEST assigned as a card file is identified by the DATA control 
card. If the program does not require a card file, only the EXECUTE control statement is necessary and 
can be entered through the card reader with the ‘““? EXECUTE TEST” or the console printer with the 
“EX TEST” command. 
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MODIFY 
The MODIFY statement is used to permanently change attributes within a program. 
The format of a MODIFY statement is: 


MODIFY 
[7] 
MO 


program-name _ [control-attributes] ... 


The MODIFY control statement may be abbreviated as MO. 


The MODIFY statement has the same syntax as the EXECUTE statement, but does not execute the 
program. 


Example: 

? MODIFY A/B PRIORITY 6 
The above example will permanently change the priority of program A/B to six. 
The MODIFY statement can be used to change the following attributes: 


CHARGE 

DYNAMIC.SPACES 

FILE 

FREEZE 

INTERPRETER 

INTRINSIC.NAME 

INTRINSIC.DIRECTORY 

MEMORY 

OVERRIDE 

PRIORITY 

SCHEDULE.PRIORITY 

SWITCH MIN M 
UNFREEZE - 
UNOVERRIDE | 
VIRTUAL.DISK MAX. (4 
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AFTER 


PROGRAM CONTROL INSTRUCTION ATTRIBUTES 
AFTER 


The AFTER attribute is used to conditionally schedule a program after the termination of another 
program (by program-name). 


The format of the AFTER statement is: 


[?] AFTER! rogram-name 
AF f prog 


The AFTER control word may be abbreviated as AF. 
Example: 


EXECUTE ALPHA AFTER BETA or 
EX ALPHA AF BETA 


When BETA reaches EOJ, ALPHA will be placed in the ACTIVE SCHEDULE for execution as soon as 
memory resources are available. 


If BETA was not either executing or scheduled when ALPHA was scheduled, ALPHA will remain in the 
WAITING SCHEDULE until BETA is executed and reaches EOJ, or until FS-ed by the system operator. 
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| AFTER.NUMBER | 


AFTER.NUMBER 


The AFTER.NUMBER attribute is used to conditionally schedule a program after the termination of 
another program (by. job-number) that is already in the mix or scheduled for execution. 


The format of the AFTER.NUMBER statement is: 


2] . AFTER.NUMBER 
| AN 


job-number 


The AFTER.NUMBER control word may be abbreviated as AN. 


Example: 


EXECUTE ALPHA AFTER.NUMBER 7 or 
EX ALPHA AN 7 


NOTE 
A job-number is assigned by the MCP to every job scheduled for execution on the 


‘system. Each job-number is unique and is incremented sequentially from the last 
COLDSTART. 
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| THEN 


THEN 


The THEN attribute is used to conditionally schedule execution of a program in relation to another 
program. 


The format of the THEN statement is: 


The THEN control word may be abbreviated as TH. 


Example: 
? EXECUTE ALPHA PRIORITY 14 MEMORY 20000 THEN COMPILE BETA COBOL SYNTAX 


Program BETA will be executed (compiled) as soon as program ALPHA has terminated. 
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CONDITIONAL 


CONDITIONAL 


The CONDITIONAL attribute is used in conjunction with the AFTER, AFTER.NUMBER, and THEN 
attributes and inhibits the program from being fired-up unless its predecessor successfully reaches EOJ. 
The CONDITIONAL attribute is a default statement. 


The format of the CONDITIONAL statement is: 


CONDITIONAL 


; 
oe en 


The CONDITIONAL control statement may be abbreviated as CA. 


Examples: 


? EXECUTE A/B AFTER C/D CONDITIONAL 
2? EX A/BC/DCA 
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UNCONDITIONAL 


UNCONDITIONAL 


The UNCONDITIONAL attribute is used in conjunction with the AFTER, AFTER.NUMBER, and THEN 
attributes and forces the program to be fired-up regardless of its predecessor’s outcome. 


The format of the UNCONDITIONAL statement is: 


2] UNCONDITIONAL 


The UNCONDITIONAL control statement may be abbreviated as UC. 
Examples: 


? EXECUTE A/B AFTER C/D UNCONDITIONAL 
2? EX A/B AF C/D UC 


? EXECUTE A/B THEN EXECUTE C/D UNCONDITIONAL 
EX A/B TH EX C/D UC 
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ATTRIBLTES 


The ATTRIBUTES attricute makes it possible to query the compiler 
attributes of a program. 


The format of the ATTRIBUTES statement 1s: 


Fe A TRH HH TOT RK II RE RE KK ERE HA EK KEKE KEE KK AEE RK EE 
ATTRIBUTES [ 

(?] . 
AT 


* + + © & 
* e+ hk eh 


KHER KEKEKRKEKEEKC KKK KEKE KEKE KEKE KEK KEKE KEKEEKEKEKEKKKEKKKEAEKEEKEKEKKKEK KK 


The control word ATTRIBUTES may be abbreviated as AT. 
The ATTRIBUTES statement may only appear after a QF or QP. statement. 


Compiler attributes 15 an 80 bit fitetd in the PROGRAM PARAMETER BLOCK 
(PPB&). This fteld is used by the compiter toe indicate that the compiled 
pregram requires special features in its interpreter. This may be a 
special feature which is not in the normal intercreter as in the 

COBGL MICR interpreter. This feature might also be a new S“O9P which 

has been added since the last SMACHINE LEVEL change [see LEVEL] as in 
thea SOL EXTENDED ARITHMETIC ops. Generally» each sit indicates a 
special feature. "y . 


At 680) time the MCP will insure that the interpreter has all the 
ATYRIBUTES required by the object progran. If the odject program 
and interpreter are not compatabler the MCP will disolay a message 
containing a bit string of the missing ATTRIBUTES. 


The compatability check may be skipped by using the CVERRIDE 
control attribute. . . 


CHARGE 


CHARGE 


The CHARGE attribute is used to insert a charge number into the log record for a program. 


The format of a CHARGE statement is: 


[?] [OBJ] CHARGE [=] integer 
cc 


The CHARGE control word may be abbreviated as CG. 


The integer cannot exceed six digits. If less than six digits are used, leading zeros will be assumed. This 
number will be carried in the MCP log file for subsequent analyzation. 


If the MCP’s CHRG option is set, the CHARGE statement must be used before a program will be scheduled. 
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DYNAMIC.SPACES 


The DYNAMIC.SPACES statement allows the operator to specify the maximum number of overlays that 
will ever be present in a program’s dynamic memory. 


The format of the DYNAMIC.SPACES statement is: 


DYNAMIC.SPACES 


[?] [OBJ] DS 


[=] integer 


The DYNAMIC.SPACES control word may be abbreviated as DS. 


The purpose of DYNAMIC.SPACES is to allow dynamic memory space for the Memory Links that will be 
associated with the overlayable data within a program. 


The MCP at run time will assign a value of 10 if the DYNAMIC.SPACES is zero. This attribute is normally 
used only when the exact memory requirement for a program’s data overlays is specified. 


For example: 
? EXECUTE A/B MEMORY = 20000 


The MCP will assign the program A/B 20000 bits of dynamic memory plus the following: 
(2 « AVAIL.LINK) + (DYNAMIC.SPACES » IN.USE.LINK) 


or 


(2 « 175 BITS) + (DYNAMIC.SPACES « 163 BITS) 
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* FILE « 
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“FILE 
The FILE statement may be used to query or change vartous attributes. 


The format of the FILE statement is: 


HM RH KTH KKK RIM KKM KEKE MEK UKERAKKEKEKEKEREREKEKKEKKKKEKKKKKKEK KKK 


* * 
* FILE | - 
* 1?1] f(CO8N) internal-filerid file attribute [{[+] see] * 
* | FI 7 | * 
& « 


RRR EK AK KKK EKE KKK KEKREK KER UKKE KKK EK EKEKEKKEKKEKEKKKEKKEEKKEKKKKEKKK KK 


The control word FILE may be abdbreviated FI. 


The FILE statement must have each element within the statement separated 
by at least one space» and must be terminated with a semicolon or END OF 
MESSAGE. If more than one card is required for a FILE statement» each 
of the continuation cards must have a question mark in column 1. 


The FILE statement must follow a COMPILE» EXECUTE» MODIFY» DYNAMICs> OF» 
or GP statement. If the FILE statement follows a MODIFY statements the 
MCP will modify the information in the program's FILE PARAMETER BLOCK 
C(FP8). If the FILE statement follows a COMPILE» EXECUTE or DYNAMIC 
statement» the MCP will modify the infermation in a working copy of 

the prcgram'*s FPB so that the change will pe in effect for only that 
run. If the FILE statement follows a GF or QP statement» the MCP will 
display the current setting of the FILE attributes Listed. 


The internal-file-id used in the FILE statement must refer to the name 

useo in the program that opens the file. For examples» if the external 

file-ic is to be changed for this run cnlye the FILE statement would be 
as follows: 


? EXECUTE program-nane 
? FILE internal~file-id NAME filerid; 


et 


: ‘ kKeekkikkkkkakkt 

= * FILE * 
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FILE ATTRIBUTE. FUNCTION 


ADV ADVERB [=] number The implied open adverb. Number is a 
12 bit value with the following meaning: 

INPUT 

OUTPUT 

NEW 

WITHePUNCH 

WITH.PRINT 

REWIND or WITH-INTERPRET 

REVERSE or WITH.STACKERS 

CPEN.-LOCK 

OCPEN~LOCKOUT 

Report on file missing 

Report on file Locked 

reserved 


nt ud t uo Wh Mo tt 


MOU O NOUS WN RH O 


~— pa 


ALL ALLOCATE.~AT.OPEN All of the areas requested by this file 
will be allocated at the time the file is 
opened. 
ARE AREAS C=] integer ' The number of areas assigned to the file. 
ASC ASCII The recording mode of the file is ASCII. 


ATP AUTOPRINT aan Allow the file to go to auto backup. 
Not implemented yet. 


BAC BACKUP The output of the file will be allowed to 
. go to backup. This sets BACKUP.DISK and 
BACKUP.TAPE by implication. 
BDK BACKUP.ODISK f Allows the file to go to disk backup. 
BTP BACKUP.TAPE Allows the file to go to tape backup. 
BCL The recording mode of the file is BCL. 
BIN BINARY The recording mode of the file is BINARY. 


BeA BLOCKS.eAREA C=) integer The number of blocks (physicat records) to 
an area. 


BUF BLFFERS [=] integer The number of buffers assigned to the file. 
The integer must be a positive number from 
1 to 15. 


_CPY. 


CYL 


DRI 


EBC 


EVAN 


FILE ATTRIBUTE 


COPY 
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* FILE 
*« Continued 


« 
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FUNCTION 


The entire FILE PARAMETER BLOCK except the 


internal-fiterid will be copied to the 


receiving file*’*s FPB. The internal-file-id 


wilt not be changed. 


HR REK KEKE EK K KEK KKK KEKE KKKK KK KEKE KK MK KK KEKE KEKKKEKAKKKEKEKKAKEK 


& 
* 
* 
* COPY internal-filecrid (FROM) 
* 
* 
& 
* 


‘ JOB.NUMSER 
JN job -number 
# (working copy) 


PROGRAM.~NAME program*nane 
PN Coriginal copy) 


+e et Ft FH H 


RKERKEKKKEKEKCHEEKEKCKKEKKEEERKK KEKE KKEKKEKEEKEKRKKAKKEKKEAKKEKEKKEKKKEKEKKK KK KK KK 


CYLINCER.«BOUNDARY 


DEFAULT 


DELAYED.~RANDOM 


€ 


DRIVE [C=] integer 


EeCDIC 
ECP 
£U f=] integer 


EVEN 


Each area of a disk file will start at the 


beginning of a CYLINDER when the file is 


‘directed to a disk pack or a disk 


cartridge. Not implemented yet. 


Override the disk allocation declared and 


use the file header block and record size. 


(Input disk and labeled 81700 tape files 
only). 


The file is tc be accessed as 
DELAYED-eRANDOM. 


The file will be directed to the DRIVE or 
EU specified by the integer. The drive 
must be a system disk. The integer must 
be a positive number from 0 to 15. 

The recording mode of the file is EBCDIC. 


772 


CtemeeE 


Same as DRIVE. 


The file will use EVEN parity. 


FIP 


FMS 


HA 


HDR 


INC 


IMF 


ISL 


INP 


* 

* 

* 

* 1 

* FIP 
& 

* 

* 

* 


FILE ATTRIBUTE. 


FILETYPE 
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FILE.TYPE 


RHEKKEKEKKEKKKKKKEKKEKKKE 


FORMS 


HARDWARE 


HEADER Pe 


INCREMENTeDRIVE 
INCREMENT.EU 


FUNCTION 
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* FILE * 
* Continued * 
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An output disk file will be assigned the 
specified type when it is closed and has 
been entered in the disk directory. 


KRAEMER KEKKEKEKKEEKKEKEAKKKKKKEEKKE KK KKKEKKES 


* 

DATA * 

CODE * 

{=] INTERPRETER * 
INTRP oe 
INTRINSIC * 
PSR»CECK * 

' 7 * 


REECE RK KH KEKCEKEKKEKEKAKEEKEKEKEKEKEKKKKK 


The program will be suspendeaq and the MCP 
wilt display a message for the .operator 
to load special forms in the device 
Cprinter or punch) before the file is 
opened. zi ps 


A printer or punch file will be allowed 
to go to the hardware device assigned. 


€ 


First 50 characters of messages read will 


be header information. If a file is opened 
with HEADERS the program ovecomes an MCS. 


Each area of a disk file will start on the 
next system disk drive (pack/cartridge) 

or EU (Cheadperetrack). When the last 
system drive has been used it will start 
over from drive zero again. 

Not implemented yet. 


ee 


IVMPLIED.OPEN 


IAPUT.SELECTIVITY 


INPUT 


IMPLIED.~OPEN denial set. CAlso known as 
FPB.CCBOL). 


Reads from remote files will return only 
messages from the station specified in the 
key portion of the read. 


Not implemented yet. 
eT 


Implied open is INPUT. 


INV 


LAB 


LOC 


MAX 


MUL 


NAF 


FILE ATT! 3UTE 


INVALID.~CHARACTERS 
{=} integer 


NOT mple rene 


LABLE.TYPE [=] integer 


Leck 


MAXIMUM.BLOCK.SIZE 
{=] integer 


MCPDATA number 


MULTI.PACK 


NAME C=] file-id 


NEW 


KEKKKKKAKKKKKEK 


* FILE 
* Continued 


*& 
*t 
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FUKCTION 


The integer may contain the value of Op 1» 
2» or 3» and determines the course of 
action for invalid character output to a 
train printer. 


9 = Report all lines that contain invalid 
characters. The following console 
message will be displayed for each 
occurrence: 


FILE file-name IS PRINTING 
INVALID CHARACTERS ON LPx. 


= Report att tines that contain invalid 
point. 
2 = Report once that the file is printing 
invalid characters. The fotlowing 
console message will be displayed: 
FILE file-name IS PRINTING 


INVALID CHARACTERS ON LPx. 
CONE TIME WARNING) 


3 = Do not notify operator of invalid 


character output. 


The integer value and associated label 
types are as follows: 


0 = ANSI 
1 = Unlabeled 
2 = Burroughs 


The file will be LOCKED, if stilt open» 
at program termination (0S or normal EQJ). 


Fixed olock size to be used for variable 


Langth records. 


Used to pass the address of a list of 
files to be dumped to SYSTEM/LOAD.DUMP. 


The file will be considered a multi=pack 
file (MPF). 


The external filer-id or disk-pack-cid. 
If only the disk pack-id is to be 
changed the PACK.ID attribute may be used. 


Implied open is NEW. 


characters and stcp the program at that 


KEKKKKKKKkKeKKKEK 
» 2 . * FILE ¥X 
* Continued * 
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FILE ATTRIBUTE , FUNCTION 
NC file~attribute When this option is used it will negate 
NGT the file-attribute following the word 


NO or NOT. For example» a file assigned 
to go strictly to backun dould be changed 
to go to the printer by entering a 

NO BACKUP file statement. The following 
is List of file-attributes that the NO 

or NOT statement can negate. 


AUTOPRINT 
ALLOCATE.SAT.OPEN 
BACKUP 
BACKUP.DISK 
BACKUP. TAPE 
CYLINDER. BOUNDARY 
DEFAULT 
EOP 
FORMS 
HARDWARE 
HEADER 
INCREMENT.DRIVE 
INCREMENT.EU 
IMPLIED.OPEN 
INPUT 
INPUT.~SELECTIVITY 
LOCK 

‘ MULTI.PACK 
NEW 
OPEN.LOCK 
OPEN.~LOCKOUT 
OPTIONAL 
QUTPUT 
QUEUE.OLD 
REVERSE 
REWIND 
TRANSLATE 
USER»BACKUP.NAME 
VARTABLE 
WITH INTERPRET 
WITH.PRINT 
WITH.PUNCH 
WITH. STACKERS 


WORK.FILE 7 
NST NUMBER.STATIONS Maximum number of stations with which this 
file is to communicate. 
OCD i The file will use ODD parity. 
OPT OFTIONAL Select OPTIONAL file (COBOL only?. 


PID PACKeID C=) disk-pack-id 


PSE 


PTN 


PIG 


RAN - 


RST 


REE 


REV 


REW 


SAV 


SER 


SNC 


FILE ATTRIBUTES 


PSEUOO 


PROTECTION 
DEFAULT 
PUBLIC 
PRIVATE 
GUARD 


C=] 


PROTECT.I0 
1.0 
INPUT 


CUTPUT 


(=] 


OFEN.~LOCK 
OFEN.-LOCKOUT 


Q.FAMILY.SIZE 
{=] integer 


Q.MAX.MESSAGES 

{=} integer 
QUEUE.OLD 
RANDOM 


oa 


READER.~SORTER-«STATIONS 
C=] integer 


RECORDS.8LOCK 
C=] integer 


REEL £=]}] integer 


REPITIONS C=] integer 


REVERSE 


REWIND 
SAVE [=] 


integer 


SERTAL 


SERTAL NUMBER 


¥KkKARKKkkkEKkKKKK 
* FILE * 


* Continued «* 
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FUNCTION 


Makes a file pseudo type. 


- 


If a NEW file is created» it will have the 
protection specified. DEFAULT for programs 
running with a usercode i$ PRIVATE» without 
a usercode is PUBLIC. See also the MH 
input command 


IF a NEW file is created» it will have the 
input/output protection specified. Oefault 
is I[.0. See also the MH input message. 


©. 
oo 
’ 


Inplted open is OPEN.LOCK. 
Implies open is OPEN»LOCKOUT. 


The number of families (sub-queues) in this 


queue. 


The maxtmum depth to which the queue is 
allowed te grow before suspending the 


The file is to be accessed randomly. 


Maximum number altowed is 3. 
Currently ignored by MCP. 


The 
for 


number of togicat records per block 
fixed record-Length file. 

The determine 
the 


value of the integer will 
number of the first reel. 


The number of copies printed if file is 
sent to backup. 


Imptied open is REVERSE. 


Implied open is REWIND.j Tape will not be 
be rewound before being opened., 


A save factor renoresenting the number of 
days a tape or diskfile may ba saved. 


File is to be accessed sequentially. 


The volume serial number of the tape to be 
used. Not implemented yet. 


< 25! 


writfer. . = 


TRA 


TNF 


UNI 


VAR 
WIN 
WPR 
WPC 
WST 


WEL 


FILE ATTRIBUTE. 


TRANSLATE 


TRANSLATE.SNAME 
C=) file-id 


UNIT.~NAME 

C=] unit-mnemonic 
USER.~BACKUP.NAME 
VARTABLE 
WITH. INTERPRET 
WITH PRINT 
WITH. PUNCH 
WITHsSTACKERS 


e 


WORKeFILE 
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* FILE 
* Continued 


FUNCTION 


Soft translation is to be performed 
on each record as it is being transferred 
to or from the user's buffer. 


Associates a translate table file with 
a file to be translated. 


The file will be directed to the device 
specified by unit-mnemonic if opened 
output. 


The externalzsfile-id is to be used as the 
file-id even if the file goes to backup. 


The file will be processed using variable 
length records. 


Implied open is WITHS INTERPRET. 
cards will be interpreted. 


Punched 
Implied open is WITH.PRINT. Punched cards 
will oe printed from buffer #2. 


Implied open ts WITH.PUNCH. Cards will be 


punched from buffer #i. 

Implied open is WITH.STACKERS.»j Cards wiit 
be stacker selected. 

Assign the file as a work file used 


internally. 


* 
* 
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FILE 


FILE 
The FILE statement may be used to specify various attribute changes for both input and/or output files. 


The format of the FILE statement is: 


FILE 
[?] [OBJ] sna eens file-attribute-1 [file-attribute-2] ... = 


The control word FILE may be abbreviated as FI. 


The FILE statement must have each element within the statement separated by at least one space, and must 
be terminated with a semicolon or END OF MESSAGE. If more than one card is required for a FILE state- 
ment, each of the continuation cards must have a question mark in column 1. 


The FILE statement must immediately follow the COMPILE, EXECUTE, DYNAMIC, or MODIFY state- 
ment. The MCP modifies the information in a working copy of the program’s FILE PARAMETER 
BLOCK (FPB). 


The file-identifier used in the FILE statement must refer to the internal-file-name used in the program that 
opens the file. For example, if the external file-identifier is to be changed for this run only, the FILE state- 
ment would be as follows: 


? EXECUTE program-name 
? FILE internal-file-identifier NAME file-identifier; 


FILE ATTRIBUTES 


Following is a list of the file-attributes that may be modified at execution time with the use of a FILE 
statement. 


FILE ATTRIBUTE FUNCTION 


ALLOCATE.AT.OPEN All of the areas requested by this file will be allocated at the 
time the file is opened. 


AREAS [=] integer The number of areas assigned to the file at compile time will 
be altered to the value of the integer. 


ASCII The recording mode of the file will be changed to ASCII. 


BACKUP The output of the file will be allowed to go to backup. This 
sets BACK UP.DISK and BACKUP. TAPE by implication. 


BACK UP.DISK If the file is allowed to go to BACKUP, the output of the file 
will be allowed to go to disk backup. 


BACKUP. TAPE If the file is allowed to go to BACKUP, the output of the file 
will be allowed to go to tape backup. 


wot 


FILE 
continued 


FILE ATTRIBUTE FUNCTION 

BCL The recording mode of the file will be changed to BCL. 

BINARY The recording mode of the file will be changed to BINARY 
(80-column card and paper tape only). 

BLOCKS.AREA[=] integer Assign integer blocks (physical records) to an area. 

BUFFERS [=] integer The number of buffers assigned to the file will be altered to the 
value of the integer. The integer must be a positive number 
from 1 to 15. 

COPY The entire File Parameter Block except the internal file identi- 


fier of one file will be copied to the receiving file’s File Para- 
meter Block. The internal file-identifier will not be changed. 


SYNTAX 
| # 
JN job-number 
(working copy) 
COPY internal-file-identifier FROM . JOB.NUMBER 
PN ) program-name 


| PROGRAM.NAME{ (original copy) 


CYLINDER.BOUNDARY Each area of a disk file will start at the beginning ofa 
CYLINDER when the file is directed to a disk pack or disk 
cartridge. 

DEFAULT Override the disk allocation declared and use the file header 


block and record sizes. (Input disk and labeled B 1700 tape 
files only.) 


DRIVE[=] integer The file will be directed to the drive or EU specified by the 
integer. The drive must be a system disk. The integer must 
be a positive number from 0 to 15. 


EBCDIC The recording mode of the file will be changed to EBCDIC. 
EU[=] integer Same as DRIVE. 
EVEN The file will be changed to even parity. 
DATA 
CODE 
FILE.TYPE[=] < INTERPRETER > An output disk file will be assigned the specified type when it 
INTERP is closed and has been entered in the disk directory. 
INTRINSIC 
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FILE ATTRIBUTE 


FORMS 


HARDWARE 


INCREMENT.DRIVE 


INCREMENT.EU 


INVALID.CHARACTERS 
[=]integer 


LABEL.TYPE[=] integer 


LOCK 


MAXIMUM.BLOCK.SIZE[=] integer 
MULTI.PACK 


NAME |=] file-identifier 


FILE 
FUNCTION continued 


The program will be suspended and the MCP will display a 
message for the operator to load special forms in the device 
(printer or punch) before the file is opened. 


A printer or punch file will be allowed to go to the hardware 
device assigned. 


Each area of a disk file will start on the next system disk drive 
(pack/cartridge) or EU (head-per-track). When the last system 
drive has been used it will start over from drive ZERO again. 


Same as INCREMENT.DRIVE. 


The integer may contain a value of 0, 1, 2, or 3, and determines 
the course of action for invalid characters output to a train 
printer. 


0 = Report all lines that contain invalid characters. The 
following console message will be printed for each 
occurrence: 


FILE file-name IS PRINTING 
INVALID CHARACTERS ON LPx. 


1 = Report all lines that contain invalid characters and stop 
the program at that point. 


2 = Report once that the file is printing invalid characters. 
The following console message will be printed. 


FILE file-name IS PRINTING 
INVALID CHARACTERS ON LPx. 
(one-time warning) 


3 = Donot notify operator of invalid character output. 


The integer values and associated label types are as follows: 


Integer Value Label Type 
6) ANSI 
l Unlabeled 
Burroughs 


The file will be LOCKED, if still open, at program termination 
(DS or normal EOJ). 


Fixed block size to be used for variable length records. 
The file will be considered a multi-pack file. (MPF) 
The external file-identifier or disk pack-id will be changed to the 


value of file-identifier. If only the disk pack-id is to be changed 
the PACK.ID attribute may be used. 
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FILE 
continued 


FILE ATTRIBUTE 

NO 
file-attribute 

NOT { 


ODD 

OPTIONAL 

PACK.ID[=] disk-pack-id 
PSEUDO 

RANDOM 


RECORDS.BLOCK[=] integer 


RECORD.SIZE[=] integer 


REEL[=] integer 


SERIAL 


SAVE[=] integer 


UNIT.NAME[=] unit-mnemonic 


VARIABLE 


WORK.FILE 


FUNCTION 


When this option is used it will negate the file-attribute follow- 
ing the word NO or NOT. For example, a file assigned to go 
strictly to backup could be changed to go to the printer by 
entering a NO BACKUP file statement. The following is a list 
of file-attributes that the NO or NOT statement can negate. 


AILLOCATE.AT.OPEN 
BACKUP 
BACKUP.DISK 
BACKUP.TAPE 
CYLINDER.BOUNDARY 
DEFAULT 

FORMS 

HARDWARE 
INCREMENT.DRIVE 
INCREMENT.EU 
LOCK 

MULTI.PACK 
OPTIONAL 
VARIABLE 
WORK.FILE 


OB Ror me ao oF 


The file will be changed to ODD parity. 

Select optional file (COBOL only). 

Alter the pack-id. 

Makes file a pseudo type. 

The file will be changed to a RANDOM access file. 


The number of logical records per block for a fixed record- 
length file. 


The number of bytes assigned for the logical record will be 
changed to the value of the integer. 


The value of the integer will determine the number of the first 
reel. 


The file is to be processed sequentially. 


A save factor representing the number of days a tape or disk 
file may be saved. 


The file will be directed to the device specified by 
unit-mnemonic. 


The file will be processed using variable length records. 


Assigns this file as a work file used internally. 


FILE 
continued 


The following list of device attributes may be used to change the input or output device originally assigned 
to a file. 


CASSETTE QUEUE . 
CARD.PUNCH READER.PUNCH 
CARD.READER READER.PUNCH.PRINTER 
DISK READER.SORTER 
DISK.CARTRIDGE READER.96 
DISK.FILE REMOTE 
DISK.PACK TAPE 

MFCU TAPE.PE 
PAPER.TAPE.PUNCH TAPE.7 
PAPER.TAPE.READER TAPE.9 

PRINTER 

PUNCH.PRINTER 

PUNCH.96 


FILE ATTRIBUTE ABBREVIATIONS 


The following abbreviations may be used to identify the FILE statement attributes. 


ADVERB ADV 
ALLOCATE.AT.OPEN ALL 
AREAS ARE 
ASCII ASC 
BACKUP BAC 
BACKUP.DISK BDK 
BACKUP.TAPE BTP 
BCL BCL 
BINARY BIN 

BLOCKS.AREA B.A 

BUFFERS BUF 
CARD.PUNCH CPC 
CARD.READER CRD 
CASSETTE CAS 
COPY CPY 
CYLINDER.BOUNDARY CYL 
DATA.RECORDER.80 DRC 
DEFAULT DEF 
DISK DSK 
DISK.CARTRIDGE DCG 
DISK.FILE DFL 
DISK.PACK DPC 
DRIVE DRI 
EBCDIC EBC 
EU EU 

EVEN EVN 
FORMS FMS 
HARDWARE HAR 
INCREMENT.DRIVE INC 

INCREMENT.EU INC 

INVALID.CHARACTERS INV 
LABEL.TYPE LAB 
LOCK LOC 
MFCU MFC 
MAXIMUM.BLOCK.SIZE MAX 


FILE 
continued 


MULTI.PACK 


ODD 

OPTIONAL 

PACK.ID 
PAPER.TAPE.PUNCH 
PAPER.TAPE.READER 
PRINTER 

QUEUE 

RANDOM 
READER.PUNCH 
READER.PUNCH.PRINTER 
READER.SORTER 
READER.96 
RECORD.SIZE 


VARIABLE 
WORK.FILE 
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FREEZE 


The FREEZE control attribute will prohibit rolling a program out to disk at any time during its execution, 
thereby remaining in the same memory location regardless of the situation until End-of-Job. 


The format of the FREEZE statement is: 


FREEZE 
[?] [OBJ] 
(ER 


The FREEZE control word may be abbreviated as FR. 
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HOLD 


HOLD 


The HOLD control attribute allows the system operator to place a program into the waiting schedule 
prohibiting its execution until it is forced (FS’ed) into the active schedule. 


The format of the HOLD statement is: 


HOLD 
[?] 


The HOLD control word may be abbreviated as HO. 


The HOLD attribute may not be used with the MODIFY or DYNAMIC control statements. 
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INTERPRETER 


INTERPRETER 
The INTERPRETER attribute allows selection of a different interpreter for use by a program. 
The format of the INTERPRETER statement is: 
INTERPRETER) =———i(ai‘(ai‘(‘(‘(<‘<i<iCO;*é‘(‘(‘ C;‘;‘;~:™” 
[?] [OBJ] IN [=] file-identifier 
INTERP 


The INTERPRETER control word may be abbreviated as IN or INTERP. 


Examples: 
q EXECUTE ALPHA/BETA INTERPRETER COBOL/INTERPOO1 


2? EX X/Y IN CCC/SDL/INTERP3 
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| INTRINSIC.NAME | 


INTRINSIC.NAME 
The INTRINSIC.NAME attribute makes it possible to change the family-name of all intrinsics requested 


by a program. 


The format of the INTRINSIC.NAME statement is: 


INTRINSIC.NAME Spits sn hie 
[?] [OBJ] _— oC [=] intrinsic-identifier 


The INTRINSIC.NAME control word may be abbreviated as IT. 
The file-id portion of the intrinsics may not be changed. 


Example : 


2 EXECUTE ALPHA/BETA  INTRINSIC.NAME ZZZ.INTRIN 


or 


2 EX ALPHA/BETA IT ZZZ.INTRIN 
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an * LEVEL 


*® 
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LEVEL 


The LEVEL attribute makes it possible to query the compiler Level of a 
program. 


The format of the LEVEL statement is: . ws 


KK KKK KEK KKK KKK KE KR KKK KEKE KKK KKK EKA REKKEKKEKEKKEKEKEKKKKKEKKEKK 


LEVEL 
(?] 
LE 


* * & & ® 


* 
* 
* 
* 


REM KKHKK KEKE KE KK KE KKK KE HKKKEKEKEEEKE KEKE AKEKEKAEEEKCKEKKEAKKKKEKKKKKEKKKKKKKE 


The control word LEVEL may be abbreviated as LE. 
The LEVEL Statement may appear only after a QF or QP statement. 


The conpiler LEVEL is an indication of what SOPs generated by the 
conpiler mean. If the meaning of an S*0P is changed or an SOP is 
remwovec from the interpreter» the LEVEL is increased by 1 and the 
the user is required tc recompile his programs. The compiler LEVEL 
is not affected by the addition of a new SOP as it is usually added 
as anew feature in the compiler ATTRIBUTES. 


At BOJ the MCP will insure that the program and its interpreter are the 
same LEVEL. This check may be bypassed with the OVERRIDE control 
attripite. ; . 


INTRINSIC.DIRECTORY 


INTRINSIC.DIRECTORY 


The INTRINSIC.DIRECTORY attribute makes it possible to reference intrinsic files from a selected 
removable disk pack. 


The format of the INTRINSIC.DIRECTORY statement is: 


INTRINSIC.DIRECTORY 


[=] disk-pack-id 
ID 


[27] [OBJ] 


The INTRINSIC.DIRECTORY control word may be abbreviated as ID. 


Example: 
2? EX ALPHA/BETA  INTRINSIC.DIRECTORY  UTILPACKA 
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MEMORY 


The MEMORY attribute makes it possible to override the dynamic memory size assigned by the compiler 
for a given program at execution time. 


The format of a MEMORY statement is: 


MEMORY 
ME 


oar aan 


[2] [OBJ] [=] integer 


The MEMORY control word may be abbreviated as ME. 
The integer expresses the dynamic memory size Firs ) 
The program will be terminated if there is not enough dynamic memory assigned to execute. 


When the MEMORY statement is used following a compile statement, the memory will be reserved for the 
compiler, not the program being compiled. 


Examples: 
? COMPILE _ program-name COBOL SYNTAX MEMORY = 50000 
or 
? COMPILE  program-name COBOL SYNTAX 
? MEMORY = 50000 


Both of the above examples will assign 50,000 bits of dynamic memory for the compiler. The following 
example will assign 50,000 bits of dynamic memory for the execution of a program. 


2 EXECUTE  program-name MEMORY = 50000 
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MEMCRY-STATIC 


The MEMORY.STATIC attribute makes it possible to query or override the 
STATIC.MEMORY size assigned by the compiler. 


The format of the STATIC.MEMORY statement is: oe 


RH RK KE KKK KE KKK KEKE KEK KKK KHEKKKKKK KK KEKE EKEKEEEEKKEKEKKEKAKEKKHKKK 


* «*« 
* MEMGRY.STATIC * 
* {?) foBs) {=] integer * 
* MS * 
* *« 


KE KRKEKKEKE EEK KKK KKK KKKKEEKKEKRKKKE KEKE KEK RKEKKEEKREKEEKEKKKEKEKKEKKKKKKEK KK 


The control word MEMORY.~STATIC may be abbreviated as MSe 


The integer expresses the static memory size in bits. 


: : kek&kkkkkrkkkk 
: ; * OVERRIDE * 
KeKKKKKaKKEK 


OVERRICE 


The OVERRIDE attribute makes it possible to bypass the compatibility 
check normally made between a program and its interpreter. 


The format of the OVERRIDE statement is: 


RHR KEK KEKE KEK RK KK KR KEK KK KK KEKKEKHKKEKEKEKKEKKaEKKKKE 


OVERRIDE 
{[?] {fOBJ] 
OV 


* t+ e+ & 
* e+ bh & H 


KR KKK KHER KEKE KH KKK KEKE KEKE EME EKEKKEKEKKEREREEKEKEKEKEKKEKKKKKEEKEKEKKEK 


The control word OVERRIDE may be abbreviated as OV. 

At BOJ time the MCP will perform a compatibility check of a program and 
its interpreter uniess OVERRIDE is specified. The compatibility check 
consists of the following: 


Interpreter HARDWARE TYPE is "U" (CUniversal) or matches the type 
of the processor it is running on. 


Interpreter's MCP LEVEL matches the MCP*s tevel. 
Interpreter's GISMO LEVEL matches GISMO's Level. 
Interpreterts COMPILER LEVEL matches the programs LEVEL. 


Interpreter's ARCHITECTURE (Clanguage) matches the program's 
INTERPRETER FIRST NAME. 


Interpreter has at least every ATTRIBUTE required by the program. 
QOVERRICE will not bypass the MCP*sS name generation process. 


OVERRICE may be reset with UNCVERRIDE thus causing the compatibility 
check to be performed. 


sdbdilia a 


kkrkarkke 
a : * PAD * 
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PAD 


The PAC attribute makes. it possible to query or alter the program's 
initiat scratch pad settings. 


The format of the PAD statement is: 


HR KKARK KK KKK KKK KEKE KKK KK KEKE KEKE KKREKERKEKKEKKKEKKKEKEKKEKK KKK KK KK 


* PAD A } * 
* {?] CoBJ3 integer , number * 
* PA B * 
« * 
KREGER KKK KKEKKRHKKKKKEKI KK EKKEKHKEKAEEKEKEAKEEKAKKEKKEKKKE KEKE KKK KEK 


The control word PAD may be abbreviated as PA. 


The integer must be a positive number from 0 to 15 and specifies which 
scratch pad is to be accessed. The following tetter specifies which 
hesisphere is to be accessed. 


The number must be at most 24 bits in length. 


‘ | : KREKKKKKKKKE 
; . * PROTECT * 
: wkkKaeKKKKHKKK 
PRCTECT 
The PROTECT attribute protects the job from certain input messages. 
The format of the PROTECT statement is: 


HoH Rte Rte eK Ht TK KEK MEK KE EKER AKER EKKKKKKKKKEKK KK KKK KE 


* 
. PRCTECT * 
m2 C?] tons) ¢ * 
* PT *& 
* * 


REN REAR DS RES EE REELS EREREEE SERS EER EERE A ERR ERAS REAM KR ER 
The PRCTECT control word may be abbreviated as PT. 
The following input messages are disallowed if the PROTECT flag is set: 
DS» DOP» GT» ST» SW. 
These messages may be entered from the remcte console which spawned the 
joo is the PROTECT flag is set. 


If the job goes to DS or DP» the PROTECT flag is reset to allow the DS 
or CUP. 


See also the LP input message. 


PRIORITY 


PRIORITY 


The PRIORITY attribute specifies the operational priority assigned to a given program. 


The format of a PRIORITY statement is: 


[2] [OBI] gee 
— PR 


[=] integer 


The PRIORITY control word may be abbreviated as PR. 


The system operator has the ability to assign program priorities to maximize output and scheduling. 
Priorities range from zero to fifteen (0-15), where zero is the lowest and fifteen is the highest. 


When a PRIORITY of nine or greater is specified, the following action occurs in a multiprogramming mode: 


a. If necessary, jobs which are running and which have a lower priority will be ‘“‘rolled-out”’ 
from memory to disk to create space for the high-priority job. This action is called “‘crashout.”’ 


b. <A high-priority job entered in the schedule will not automatically suspend any other high- 
priority job running in memory. However, the system operator may stop (ST) them. 


c. Upon termination of the high-priority job, the suspended programs will be automatically 
reinstated to memory. 
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SCHEDULE.PRIORITY 
The SCHEDULE.PRIORITY attribute assigns priorities of programs in the schedule. 


The format of the SCHEDULE.PRIORITY statement is: 


[?] [OBJ] 


SCHEDULE.PRIORITY 
c..|.0U}!}!!t”t”;~S [=] integer 


The SCHEDULE.PRIORITY control word may be abbreviated as SC. 


The priorities of the schedule are separate from the mix priorities in that SCHEDULE.PRIORITY will only 
alter or assign priorities pertaining to the schedule, not the mix. 


The priority integer must be equal to or less than fourteen. 


Jobs in the ACTIVE SCHEDULE having the same assigned priority are further discriminated by the actual 
time the jobs have been in the schedule. 


os 


? EXECUTE A/B SCHEDULE.PRIORITY = 12 
NOTE 


Once the program has been placed in the schedule, the SP 
console message must be used to change the scheduled priority. 
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SWITCH 
The SWITCH control attribute allows the system operator to set programmatic switches. 


The format of the SWITCH statement is: 


[7] [OBI] — os ot vata 


The SWITCH control word may be abbreviated as SW. 
The integer must be a decimal digit from zero to nine (0-9) that references the switch to be set. To deter- 
mine what switches are available, the specific language manual for the program for which the switches are 
being set must be referenced. If the “=” option is used, all ten switches are implied (40 bits of information). 
The value is the value that the switch or switches are assigned. 
Examples: 

? SWITCH 0 = 5 SWITCH 1 = 3 

? SW 0=5 SW 1=3 

2? SW = @0123456789@ 


To modify or query the switches after the program has gone to BOJ, use the SW and TS commands, 
respectively. PA 
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The 


The 


The 
The 
the 


kkekekeuike 
ae * TIME « 
; kKkekk&KKKK 


TIME attribute specifies the maximum run time. 


format of the TIME Statement is: 


RKREKEKMEKEHRE KEKE KEKE KE EKER EEE K EKER KEK EKKEKEEKEKEKEKKKKKKEKKKKEKEKKEK 


* , * 
* TIME rs 
* (?] fCOBJ] C=] integer & 
* TI * 
* * 


REMAKE KEKE KEKE KEKE EKER KKEMEKEKE KKK EK KKEKRERKEKEKKEKEEKEENKKKKKKKKKEK 


TIME control word may be abbreviated as TI. 


« 


integer value is tne maximum processor time in minutes after which 
job will be DS-ed. 
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TRACE 


The TRACE attribute makes it possible to set the initial TRACE option 
for a program prior to 80J. 


The format of the TRACE statement is: 


MKRKEKKKKEKEEKEKEKEKRKEKEKEKAKE EE KKEKEEKEKEKKKEKEEKEKKREKKEEKEEKEKEKKKEKKKKKEKKEKEK 


* 
* TRACE * 
* {?] [(08J) integer 
* TC * 
* ‘ * 
RARER KEKKEKEKKKAKKKEEKEKEEKEKKEKEEKARKKEKEKEKEKEMKKEKAKKKKCEKEKKEKRKKKEKEHEKEKEKEK 


The control word TRACE may be abbreviated, as IC. 
The integer must be a positive number from 0 to 15. 


See also the GT and NT input messages. 
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| UNFREEZE | 


UNFREEZE 


The UNFREEZE attribute allows the system operator to remove the FREEZE condition from a program, 
thus permitting the rolling-out to disk of a program that is in an interrupted state. 


The format of the UNFREEZE statement is: 


UNFREEZE 


[7] [OBJ] iG 


The UNFREEZE control word may be abbreviated as UF. 
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: : ~ kkKEKKKKKKKKKkKkKKE 
— « UNOVERRIDE * 
RHEAEKKEKKKKEKEKKE 


UNGVERRIDE 


The UNCVERRICE attribute makes it possible to reset the action of the 
OVERRICE statement. 


The format of the UNOVERRICE statement is: 


MEME KCKAMEKAEAKKEHAREKEKEKKK KEKE KEKHAKKKEEEEKKEREEKHEKKHKEEKREKKKKKRKEKAKK 


* UNOVERRIDE - 
* C?] (OBJ) 7 * 
* UV * 
* , x 
PT HK HK KKK HTM KKK MIKE KEK EK KEKE ARAKI KHEKEKEKKKEKKKK 


The control word UNOVERRIDE amy be aborevjates as UV. 


UNCVERRIDE makes to possible to execute a program with compatibitity 
checking which has been modified with OVERRIDE. 
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VIRTUAL.DISK 


VIRTUAL.DISK 


The VIRTUAL.DISK attribute gives the operator the ability to change the number of disk segments 
assigned by a compiler for saving data overlays during execution. 


The format of the VIRTUAL.DISK statement is: 


VIRTUAL.DISK 


VI [=] integer 


[?] [OBJ] 


The VIRTUAL.DISK control word may be abbreviated as VI. 
Integer must be eight digits or less. 


If the integer is zero and the program requires disk space for data overlays, the MCP will assign a default 
size of 1000 segments. 
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DATA 


FILE PARAMETER INSTRUCTIONS 
DATA 
The DATA control instruction informs the MCP of the name of a punched card data file. 


The format of the DATA control instruction is: 


a file-identifier 


The control word DATA may be abbreviated as DA. 


The DATA control statement must be the last control instruction prior to the actual data. 
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END 
The END statement indicates to the MCP that the card data input has reached the End-of-File (EOF). 


The format of the END statement is: 


? END 


The END control statement cannot be abbreviated. 


When the END statement is used it must be the last card in that file. It signals the MCP to close the file, 
and makes the card reader available to the system. 


The END control card is not required at the end of a data deck if the program recognizes the last card in 
the file and closes that file without trying to read another record. However, if the program does try to 
read another record from that file and the card reader is empty, the MCP will hold the card reader waiting 
for more data or a ““? END” statement to be read. 


If a data card with an invalid punch in column | is read within a data deck, the MCP stops the card reader 


and notifies the operator that the card just read has an invalid punch in column (1). This allows the 
operator to correct the card and permit the program to continue reading cards. 
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“AB INPLT MESSAGE (Auto Backup) 


The AB ingut message is used to specify the number of auto backups to be 
used and to assign a printer to auto backup. 


The format of the AB message is? 


KRKARKKKKK KAKA KEKKEKKEKEEKKE KARE KEEAEKEKEKEKEKEKKEKRKEEKEKEKEKEKKEKKEKEK 
‘ | 

integer i * 

(?). AB . * 

C-] LPx [ eee ] * 

* 


++ © * 8 


RE EKKMKE KKK REKKKK EMH KKM KE KKK AKRKKEEKEKAKKEKEKEKEKEKEAKEKKEKKKEKEKEKKKEKKEK KEK 


The integer must be a positive number from 0 to 7. If the integer is 
greater than zero» AUTO BACKUP will be activated and the designated 
number of SYSTEM/BACKUPS will be executed. SYSTEM/BACKUPS will remain 
in-the mix as long as there are backup files to be printed and wilt 
terminate when there are no more backup files to be printed. when a 
backup file is closed which is to be autoprinted and there are no 
SYSTEM/BACKUPS AUTOPRINTING but the A3 integer is greater than zeropr 
the necessary number of SYSTEM/SACKUPS will be Initiated. If the 
integer is zera» the current SYSTEM/BACKUPS AUTOPRINTING will terminate 
when finished printing the current file. 


AB LPx reserves for AUTO BACKUP the specified printer. This printer 
witl orly be used by a SYSTEM/BACKUP tnitiated by AUTO BACKUP. A383 
“LPx wili remove the printer from being reserved for AUTO BACKUP and 
will return it to the system for use by any program requesting a 
printer. 


It is the operators resporsitbility to match the number of printers 
reserved for AUTO SACKUP with the number of SYSTEM/BACKUPS specified 
by AB integer. ; 


Both the integer and printer reservations will be preserved through 
CLEAR/ STARTS. 


ALL backup disk files with the multi.file.id of "BACKUP.PRI™ which are 
sent to the pack designated by 8D after Asb Integer is specfied will 

be printed by AUTG BACKUP. To avoid AUTO BACKUP specify a 
USERs«BACKUP.NAME with a multi-file-id other than "BACKUP.PRI™. 

The BO input message will not be honored while AUTO BACKUP is active. 


This message is not allowed from remote operators. 


SYSTEM CONTROL INSTRUCTIONS 

AX INPUT MESSAGE _ (Response to ACCEPT) 

The AX message is a response to an ACCEPT message requested by an object program through the MCP. 
The format of the AX message is: 


mix-index AX ...input message... 


All responses are assumed to be alphanumeric format. The input message starts in the first position after the 
AX on the input line, and continues until the END OF MESSAGE button is pressed. 


If the End-of-Message is depressed immediately after the AX, the MCP fills the area in the requesting pro- 
gram with blanks. 


Example: 
2 AX CHECK VOID IF OVER 500 DOLLARS 


Input messages shorter than the receiving field in the program will be padded with trailing blanks. Longer 
messages will be truncated on the right. 


The AX message has an unsolicited console feature in that the operator may enter as many AX message 
responses as needed for a given program prior to the actual ACCEPT. The AX messages must be entered 
in the order they will be used, since the queue is structured on a first-in, first-out basis. 


The queue is automatically cleared at program EOJ or an abort. 
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BB INPUT MESSAGE _ (Backup Blocks per Area) 


The BB input message allows the operator to specify the number of blocks to assign each area of a 
printer or punch backup disk file. 


The format of the BB message is: 


BB [integer] 


The value of the backup blocks per area is set to 200 by COLDSTART, and if the integer entered in the BB 
message is less than 5, a value of 200 is assigned by default. 


If an integer is not entered with the BB message, the MCP displays the current setting of the backup blocks 
per area. 


Examples: 
BB 


BB 350 
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BD INPUT MESSAGE (Backup Designate) 


The BD input message allows the operator to designate a specific disk pack or disk cartridge for backup 
files. 


The format of the BD message is: 


BD [disk-pack-identifier ] 


When the BD message is entered without the disk-pack-identifier the MCP will cause the current setting of 
the default backup disk to be displayed. 


If “ * (the quotes are required) is entered for the disk-pack-identifier, the default backup disk is changed to 
the SYSTEM disk. 


Examples: 
BD 
BD USERPACK 


BD ee 99 
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BF INPUT MESSAGE = (Display Backup Files) 
The BF input message lists disk backup files on the console printer. 


The format of the BF message is: 


= /= 
integer 
BF [pack-identifier/] < PRT/= 
PRN/= 
PCH/= 


The PRT/= option will list all printer backup files on disk. The PCH/= option will list all punch backup 
files on disk. 


The =/= option will list both the printer and punch backup files that are stored on disk. 
PRN and PRT are both to be assumed to mean printer backup files. That is, PRN and PRT are equivalent. 


The unit-mnemonic requests displaying the backup files on the designated removable disk drive. If it is 
omitted, the MCP will display the backup files resident on system disk. 
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CD INPUT MESSAGE _ (List Card Decks in Pseudo Readers) 


The CD input message allows the system operator to obtain a list of the pseudo card files and their file 
numbers that have been previously placed on disk by SYSTEM/LDCONTRL. 


The CD message format is: 


ee 


The MCP displays the number of each pseudo deck and the first fifty (50) characters of the first card in 
the deck. 


If a deck is in use, its name and the program using it are displayed. 
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CE INPUT MESSAGE (Change to Entry System Software) 


The CE input message allows the operator to specify that during the next Clear/Start MCP I system 
software and firmware will be loaded on the system. 


The format of the CE message is: 
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fa 


CL INPUT MESSAGE = (Clear Unit) 

The CL input message allows the operator to clear a unit on the system because of an apparent system 
software loop or hardware malfunction. Any program using the unit that has been cleared using the 
CL message will be discontinued (DS-ed). 


The format of the CL message is: 


CL unit-mnemonic | 


The CL message cannot be used with disk devices (DCx, DKx, DPx). 


Example: 


CL LPA 
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CM INPUT MESSAGE = (Change System Software) 


The CM input message allows the operator to identify programs to the system for subsequent usage. 
The purpose of the CM message is to identify a file that contains the program to be used for a desig- 


nated function. 


The format of the CM message is: 


program-identifier 
PURGE 


CM __system-software-mnemonic 


ae er rn A 


The resultant action of the CM message does not take affect until the next Clear/Start. 
The PURGE option removes the file from the designated NAME TABLE entry. 


Refer to the Clear/Start procedure for a list of the system software mnemonics that are used in the 
NAME TABLE. 


Example: 
CM MX MCP/XYZ 


The CM message at the next Clear/Start makes the program MCP/XYZ the experimental MCP. 
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CN INPUT MESSAGE (Change to Non-Trace System Software) 


The CN input message allows the system operator to change the operating environment to non-trace 
system software after the next Clear/Start. 


The format of the CN message is: 


CAUTION 


The CN input message is strictly for system software 
development and debugging. It should not be used 
in the standard operating environment. 
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CP INPUT MESSAGE = (Compute) 


The CP input message allows the operator to perform simple arithmetic functions on the console printer, 
as well as decimal/hexadecimal conversion. 


The format of the CP message is: 


CP integer-1 [operator integer-2] ... [=] 


The valid operators recognized by the CP message are as follows: 


+ addition 

- subtraction 

: multiplication 
/ division 


M MOD (remainder divide) 
The equal sign (=) terminates the expression and must be the last entry when entered from a card reader. 
The CP message will evaluate an arithmetic expression strictly on a left-to-right basis. Therefore, quantities 


contained in parentheses or brackets are invalid. Spaces are not used as delimiters and are ignored. 


Operands and intermediate results are considered positive integers, and overflow beyond 16777215 will be 
truncated. 


The response is displayed in both decimal and hexadecimal formats. 
Example: 
request: CP @ 3A@ * 4+ @F@ 


response: CP: @QOO0OOF7@=247 


CP @F@ 


CP: @00000F@=15 
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CQ INPUT MESSAGE (Clear Queue) 


The CQ input message causes all messages stored in the Console Printer QUEUE to be cleared. 


The CQ message format is: 
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CS INPUT MESSAGE = (Change to Standard System Software) 


The CS input message allows the system operator to insure that during the next Clear/Start MCP II system 
software and firmware will be loaded on the system. 


The format of the CS message is: 
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CT INPUT MESSAGE — (Change to Trace System Software) 


The CT input message allows the system operator to change the operating environment to trace system 
software after the next Clear/Start. 


The format of the CT message is: 


CAUTION 


The CT input message is strictly for system software 
development and debugging. It should not be used 
in the standard operating environment. 


CU 
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DF INPUT MESSAGE (Date of File) 


The DF input message allows the operator to display on the console printer the compilation date and time 
for code and interpreter files, and the creation date for all other types of files. 


The format of the DF message is: 


DF  jfile-identifier 
family-name /= 
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DM INPUT MESSAGE (Dump Memory and Continue) 


The DM input message allows the system operator to dump the contents of a program’s memory space to 
disk for subsequent analysis by DUMP/ANALYZER. 


The format of the DM message is: 
mix-index DM 


Processing automatically continues when the dump is finished. 


The DM message will create a file called DUMPFILE/integer. The integer will be incremented by one each 
time a DM is performed in order to make each DUMPFILE unique. 


The DUMPFILE may be printed by the DUMP/ANALYZER program. Refer to the ‘“‘PM” message. 
Example: 


2 DM 


2-61 


DP INPUT MESSAGE = (Dump Memory and Discontinue) 


The DP input message allows the system operator to initiate a memory dump during a program’s execution, 
ind then abort that program. 


The DP message format is: 


mix-index DP 


The input of the DP message signals the MCP to halt program execution, dump memory out to disk, and 
abort the program as though a DM message had been entered immediately followed by a DS message. 


Example: 


1 DP 
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DR 
DT 


~_ INPUT MESSAGE (Change MCP Date) 


{DR 
DT 


The DR, DT input message allows the system operator to change the current date maintained by the MCP. 


The DR, DT message format is: 


IS bs 


mm/dd/yy 


The MCP will accept only valid dates. The month entry must be between one and twelve, the day must be 
between one and thirty-one, and the year must be valid numeric digits. 
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DS INPUT MESSAGE _ (Discontinue Program) 
The DS input message permits the system operator to discontinue the execution of a program. 


The format of the DS message is: 


mix-index DS 


The DS message may be entered at any time after the BOJ and prior to EOJ. 
The DS message signals the MCP to stop the program’s execution and return the memory the program 


occupied to the system. Any files not previously entered into the disk directory are lost and the disk 
area occupied is returned to the disk available table. All other files are closed. 
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ED INPUT MESSAGE — (Eliminate Pseudo Deck) 


The ED input message allows the system operator to eliminate a deck from a pseudo reader. This is equiva- 
lent to flushing the reader and then performing an RY message. 


The format of the ED message is: 


ED integer 


The deck will be eliminated from the pseudo reader and from the disk directory by the ED message. 
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EM INPUT MESSAGE (ELOG Message) 
The EM input message allows the operator to place a message into the ELOG. 


The format of the EM message is: 


| EM input-message 


The input-message starts in the first position after the EM on the input line and continues until the END OF 
MESSAGE is pressed. 
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ET INPUT MESSAGE — (ELOG Transfer) 


The ET input message transfers the information in the file SYSTEM/ELOG to the file ELOG/ # integer. 
The program SYSTEM/ELOGOUT is then executed label equating ELOG/ #integer and prints the file. 


The format of the ET message is: 


ee 


FF 
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FM INPUT MESSAGE (Response to Special Forms) 


The FM input message is a response to the “SPECIAL FORMS REQUIRED” message. 


The format of the FM message is: 


mix-index FM _ unit-mnemonic 


The unit-mnemonic designates which unit is to be assigned to the file. 


The message 


program-name = mix-index SPECIAL FORMS REQUIRED FOR file-id 


is displayed on the console printer requiring that a FM message be submitted by the system operator before 


the file can be opened. 
Example: 


3 FM LPA 
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FN INPUT MESSAGE _ (Display Internal File Name) 
The FN input message allows the system operator to display the internal file names of an object program. 


The format of the FN input message is: 


FN program-name _ external-file-identifier | 


ed 


The MCP lists on the console printer all the internal-file-names of the object program which have the 
specified external-file-identifier in the following format: 


FN = internal-file-identifier-1 
FN = internal-file-identifier-2 
FN =... 
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FR INPUT MESSAGE (Final Reel of Unlabeled Tape File) 


The FR input message gives the operator the ability to notify the MCP that the last reel of an unlabeled 
tape file has completed processing, and there are no more input reels to be read. 


The format of the FR message is: 


mix-index FR 


The FR message is a response to the message: 
mix-index NO FILE 


This message is the result of an unlabeled tape file reaching the End-of-Reel; the FR message notifies the 
program that the file has reached EOF. 


The FR message is also allowed with labeled tape files in order to signal EOF without reading all of the 
reels of the file. 


The FR message must be used with paper tape input files to signal EOF after all reels have been processed. 
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FS INPUT MESSAGE _ (Force from Schedule) 


The FS input message is used to force jobs from the WAITING SCHEDULE into the ACTIVE SCHEDULE. 


The format for the FS message: 


job-number 
FS Ea 


The equal sign option will force all jobs into the ACTIVE SCHEDULE. 


See the HS message for placing a job in the WAITING SCHEDULE. 


NOTE 


The WAITING SCHEDULE is a schedule of jobs that are waiting to be placed in 
the ACTIVE SCHEDULE. For example, an EXECUTE with the attribute THEN 
or AFTER.NUMBER would place the program in the WAITING SCHEDULE. 


The ACTIVE SCHEDULE are those jobs that have satisfied all the requirements 
for execution and are only waiting for memory space to run. 


In order for a program to be in the mix, it must have gone to BOJ. 
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FT INPUT MESSAGE ~— (Change File Type) 


The FT input message allows the operator to change the type of a disk file in the disk directory and file 
header. 


The format of the FT message is: 


FY  file-identifier file-type 


By using the FT message the file type is the only change made to the file; the format of the file remains 
the same. 


A CONTROL type file is a pseudo file or control deck. 


A CODE file is the only type of file that an EXECUTE, MODIFY, COMPILE, or DYNAMIC statement 
may be valid as an operation. 


The LT message will list the file types. 
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GT INPUT MESSAGE (Go Trace) 


The GT input message allows the system operator to request that a 
programs interpreter trace each opcode specified. 


The format of the GT message is: 


RAREWKEKKKAEKKKEEKEKKEK KEKE KE KKK KEKEKKEKEKEKEEKEKEKKEKEKKEKEKEKKKKKKKKKKKKKK 


* * 
* mixsindex GT integer . * 
* x 


MAREK EKA KKKKAKAEKKKKEKAKKEKEKK KEKE EKKKKKKKEKEKEEKEEKKEKEKAKKKKKKKKKKEK 
The integer can be: 


no trace ‘ 
trace branch opcodes 

trace store opcodes 

trace all other opcodes 


fne S 
How on it 


or any sum of the above. 


See also the TRACE attribute. 
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GO INPUT MESSAGE (Resume Stopped Program) 


The GO input message is used by the system operator to request resumption of a program that has been 
stopped (ST message). 


The format for the GO message is: 
mix-index GO 


A program retains its assigned mix-index number when STOPped and rolled-out to disk. The MCP uses 
this mix-index number in the GO message to identify the program for resumption. 
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HS INPUT MESSAGE (Hold in Waiting Schedule) 


The HS input message will allow the system operator to place a HOLD on a specific job(s), thereby 
temporarily removing them from the ACTIVE SCHEDULE. 


The format of the HS message is: 


job-number 
HS = 


The equal sign (=) option will place all jobs in the ACTIVE SCHEDULE into the WAITING SCHEDULE. 
A job-number is assigned when a program is scheduled by the MCP. 


A job that has been placed in the WAITING SCHEDULE by a HS message will remain in the WAITING 
SCHEDULE until FS-ed. 
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HW INPUT MESSAGE (Hold in Waiting Schedule until Job EOJ) 


The HW input message allows the system operator to designate that certain jobs are to be placed in the 
WAITING SCHEDULE, awaiting the EOJ of another job (by job-number). 


The format of the HW message is: 


job-number-] 


job-number-2 


The equal sign (=) option will place all jobs in the ACTIVE SCHEDULE into the WAITING SCHEDULE, 
and mark them as waiting for the completion of job-number-2. 


A job that has been placed in the WAITING SCHEDULE by a HW message will remain in the WAITING 
SCHEDULE until job-number-2 reaches EOJ or until FS-ed by the operator. 
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IL INPUT MESSAGE _ (Ignore Label) 


The IL input message allows the system operator to ignore the label on the file mounted on the designated 
unit. 


The format of the IL message is: 


er sen te tn en nr 


unit-mnemonic 
# integer 


mix-index IL 


The mix-index must be used to identify the program. In a multiprogramming environment there may be 
more than one ““NO FILE” condition at a time. 


The IL message may be used in response to the following messages: 

NO FILE... 

DUPLICATE INPUT FILE... 

file-identifier NOT IN DISK DIRECTORY 
It is assumed that the system operator knows that the file on the unit selected is the file needed regardless 
of the original file-identifier’s location. If the unit-mnemonic specifies a disk drive, the directory on that 
drive will be searched for the required file-identifier. The # integer option is used to designate a pseudo- 
reader (by number) as the input device. 

NOTE 
A RESTRICTED disk cannot be assigned to a program with 


the IL message. The program must have the correct dp-id 
prior to the opening of the file. 
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KA INPUT MESSAGE (Analyze Disk Directory) 


The KA input message allows the system operator to analyze the contents of a disk directory, including 
file area assignments. 


The KA message has three formats: 


Format 1: : 

KA disk-pack-id/=/= 

= el 
Format 2: 

disk-pack-id/DSKAVL/ | 

KA SS 

= DSKAVL { 
Format 3: 

KA [ disk-pack-id/] family-name/= | 


=< file-identifier | 


Inclusion of the disk-pack-id causes the MCP to list the requested information for the specified user disk 
pack or disk cartridge; otherwise, system disk is assumed. 


Format | results in a listing of available areas followed by a description of all files contained on the specified 
disk. 


Format 2 lists only the available areas for the designated disk. 
Format 3 lists only the description of the specified file or files. 
Examples: 

KA =/= 

KA USER/=/= 

KA DSKAVL 

KA USER/DSKAVL/ 

KA COBOL 

KA RPG/= 


KA USER/PAYROLL/= 
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KP INPUT MESSAGE (Print Disk Segments) 


The KC or KP message provides a means for the system operator to print selected disk files or segments of 
a disk on the line printer. 


ea 


The format of the KC or KP message is: 


[integer-3 ] 


‘ file-identifier 
} integer-2 


te os, integer-1 | 
unit-mnemonic 


The printout created by the KP message is in HEXADECIMAL format. 
The printout created by the KC message is in CHARACTER format. 


The file-identifier option will print a file by that name. The DISK option is used for the Head-per-Track 
disk. Integer-1 is required with head-per-track disk and designates the electronics unit. 


Integer-2 is used to specify the disk address from which printing is to begin. 


Integer-3 is used to specify the number of segments to print beginning either from the first segment of a 
file or the address specified by integer-2. If omitted, number of segments printed is one. 


Examples: 
KP ABO) 25 423 euch eeyna ees Print 10 segments of file A/B 
RE ADS eater tend oe keels’ Print 1 segment of file A/B 
RE CCG 2X Oh areata os Print 1 segment of file A on pack CCC 
KP DPA @5C@15........... Print 15 segments from HEX LOC. 5C 


KP DISK 1 200 10........... Print 10 segments on EU 1 from DECIMAL LOC 200 
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LC INPUT MESSAGE (Load Cassette) 


The LC message is used to load system programs (compilers, interpreters, object code, system software) 
from a cassette in the console cassette reader to disk with appropriate additions in the disk directory. 


The format of the LC message is: 


family-name/file-identifier 
LC [disk-pack-identifier] family-name/= 


=/= 


The LC message cannot be used to load a freestanding program that does not execute under the control 
of the MCP. 


The LC message calls the program SYSTEM/LOAD.CAS which loads the files. 
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LD INPUT MESSAGE _ (Pseudo Load) 


The LD input message is used by the system operator to initiate the building of pseudo card deck(s) on disk 
to be processed by pseudo readers. 


The LD message format is: 


LD 


After receiving a LD message, the program, SYSTEM/LDCONTRL, looks for a “? DATA CTLDCK” control 
statement that initiates the read. 


The card deck’s “file-id”’ is assigned by a ““? DATA file-id” control statement preceding the data deck to be 
read. Each data deck that is loaded will be numbered consecutively along with its file-id which is used in 
opening the pseudo card files. 


Terminating the LD function requires a ““? END CTLDCK”’ control statement immediately following the 
last data deck that is to be read. 


Example: 


The following example demonstrates how two compile decks and one data deck can be loaded as 
pseudo card files to be used by pseudo readers. 


2? DATA CTLDCK 


z, COMPILE program-name COBOL SYNTAX 
CONTROL DECK ? DATA CARDS 
DECK A 
data deck 
? END 
? COMPILE program-name FORTRAN 
? DATA CARDS 
DECK 
data deck 
B 
- END 
2 DATA file-id 
DECK data deck 
C 
? END 


_? _ ENDCTL 
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LJ INPUT MESSAGE (Larry J Thomas). 
The LJ input message is used to set the B1700 Micro Emulator key. 
The format of the LJ message is: 


RRR KEKE EKRMEKEEKEKEEEEAKEKE AKER KN CHEM KKEKEKEKEKEKKEEKEEKKKKKEKKKEKRKKKKK 


* «* 
re . [2] LJ [€number ] * 
te : * 


RRM MH KK KI HK HK KH RK HK KKK KKM RE KH KKK KKK KEK KKKKKEKEKEKKKKKKKKKKK 
The number can be 


SYSTEM/INIT to Load 31700 Emulator 

Emulate ; 

Emulator to do own I/9 

Load first 3KB of emulator into control memory 


co & NN po 
“on ott 


If number is omitted the current setting Will be displayed. 


This message is not allowed from remote operators. 
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. kkkkkk 
eu * LP * 


kekkeet 


LP MESSAGE CLock Protect) 


The LP input message is used to set or reset to PROTECT flag. 


The format of the LP message is: 


(see eee RR ESE SARA SE RARER ARARARRASRARARARLE SAAS SSAA SRR ARE SE RARER ERS EEE EE SY 


* * 
*- 
* 


mixeindex LP 


% 
| 
* » 


HERE KEKE EK HH KREME KEKE KK KK EH EKKEK KEKE REKREEKKEKKKKEKAKKKKKKKKK 


The + cption sets the PROTECT flag thus preventing the following input 
messages: : 


DS» DP» GT» ST» SW 


from being entered except at the remote console which spawned the job. 
If the job goes to a DS or DP the PROTECT flag wilt be reset. 


The 


- cption resets the PROTECT flag» thus allowing the above input 


messages to be entered. 


See 


also the PROTECT attribute. 
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LG 
LN 


LG 
ee INPUT MESSAGE (Transfer and Print Log) 

The LG, LN input message allows the system operator to transfer and print the log. The log files are 
numbered sequentially starting with LOG/#00000001. The program SYSTEM/LOGOUT is executed 


performing the necessary file equate to print the log. The program SYSTEM/LOGOUT must be in the 
disk directory in order for the MCP to accept the message. 


The format of the LG, LN message is: 


IZ |e 


bbs) 
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kkkkke 


LT INPUT MESSAGE (Load Train table) 


The LT input message is used to load the translate table for a train 
printer. j o 3 


The format of the LT message is: 


KKK KKAEREKKKC EKA KKK EEE KKRK KEKE KEKE KEKEKEKKKAKKKEHKKKKKKKKKKKEKKEKKKK 


train number 
C?] LT unitwranemonic 


+e & ee 


*« 
« 
train name ; * 
*« 
KEM MEKKEKKEK KEKE KKM KEEKKEMEEKEKKKEEKKEEKAEEKRERAEEARKKEKEKRKKKEKKEKEK 


Printers with automatic identification witl have the translate table 
loaded automatically by the MCP at CLEAR/START time or if the printer 
is RYted. The MCP assumes that the proper translate table is loaded 
on printers without automatic identification until told otherwise. 
The train name or train number may be omitted for Printer Control-2. 


The translate tables are a data file on disk created by 
SYSTEM/BUILDITIRAIN. 


This message is not allowed from remote operators. 


2°81.2 


ca 
LT INPUT a (List Fie Types : 


mula file i is to be “hha th Ft me sage, ) 


The ET: in put ee will li 


The form y f the LT mgssag 


LT 
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, * MH 
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MH INPUT MESSAGE (Modify Header) 
The MH input message 18s used to change a file's protection. 
The format. of the MH message is; 


HRM III RIK IT MK KI RE RETAKE EMER MEEK EEKKKENEK KKK 


* PUBLIC I.0 | 

* MH file-name |PTN PRIVATE PIO INPUT) CUSR #1 

* | GUARD — OUTPUT 

* ‘ 

PETE TC RT SCLOTCLCLCLCCCCLCSCLCLCT CL CIT STSCI CCC CCC CCT TTT LTT TT tS 


PTN CPROTECTIGN) specifies the access rights of the file. If PUBLIC 
is specified» no userccde/password is required to access the file. 


* 
* 
x 


* 


+ he » & 


* 


If PRIVATE is specified» a usercode and password matching the file name 


or a privileged usercoce/oassword is required to access the file. 
GUARD is not implemented yet. The default for programs running with a 
usercoce is PRIVATE» for programs without a usercode is PUBLIC. See 
alsc the file attribute PROTECTION. 


PIG CPROTECTION.I0) Limits the type of access to a PUBLIC file. A CODE 
file which is INPUT is assumed to be only executables not readable. See 
also the file attribute PROTECT.I10. 


USR is a debug feature allowing the possibly erroneous user count of a 
file to be changed to the given number. 
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‘ : KEKXk&KK 
‘ . . * LS « 
7 ; kkk KKK 
LS COMMAND (Log Spo) 
The LS command causes all control messages to be inserted in the control 
QUELe. . 
The format of the LS command is: 


KEKE KKK KKK EKA KEKAK KK KEKE KKK MEK KK EKKKKEK KEKE AKHEKEEKKEKKKKEKKKKEKKEEK 


* ‘ * 
* LS * 
* * 


RHR MH K KKK KRKE KEE EER KEKE KKK KEKE KEKE EE KEKE KKEEKARKKKKAEKKKKKKKK 


ALL control messages (both input and output) will be placed in the 
control queue specified by the CU command. A QU command is required 

in the control string prior to the LS command. Control messages placed 
in the cortrol queue will not de displayed on the Local console except 
for error messages which require operator intervention or if the RMSG 
option is set. . 


A job which has been spawned with LS may not spawn another job with LS. 


This command is allowed only from ZIPs. 


DuDA FD 


MP INPUT MESSAGE (List Multi-Pack File Tables) 


The MP input message gives the operator the ability to interrogate the MCP’s multi-pack file table which 
contains all multi-pack files that have been entered in the table since the last Clear/Start or RT message. 


The format of the MP message is: 
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MR INPUT MESSAGE (Close Output File with Purge) 


The MR input message gives the system operator the ability in a duplicate file situation to save the old file 
by purging the newly created file. 


The format of the MR message is: 


mix-index MR 
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fa 


MX INPUT MESSAGE (Display MIX) 


The MX input message allows a system operator to request that the MCP display on the console printer all 
the programs currently in the MIX. 


The format of the MX message is: 


The MX response lists the priority numbers, program-names and the MIX numbers of all programs currently 
running. 


Example: 
MX 


1 PR:04 


program-name 


2 PR:05 


iH 


program-name 


END MX 
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mn) *« NC * 
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NC INPUT MESSAGE 


The NC input message allows the system operator to control how the table 
of failing memory chips is maintained. 


The format of the NC message is? 


RH REMAKE KKK KHER KKEKKKEKEKEKEKKEKEKKEKEKEAKEKEKAEKKEKEKKKEKKKKKEKKKK 


« : * 
* {?] NC lCinteger] * 
* * 


KH RKRKH HE MKC KEKE KKK KEKE KEKE KK KEKE KK KK KKKCEKKEKKEKHEKKEKEKEKEKEKEKKEKEKEKEE 


Jf the integer is omitted» the current size of the table and the size 
the table will have following the next CLEAR/START will be reported. 


The -integer has the following meaning: 


0 = Will report current size of table and set the size following 
the next CLEAR/START to the default stze Cone location per 
16K bytes).. 


1-255 = Will use the number specified as the number of locations 
to be used following the next CLEAR/START. 
4 
> 255 = Will use 2355 Logotions following the next CLEAR/START. 


On machines without error correcting memories» NC has no effect. 


This message is not allowed from remote operators. 


Aa 
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ee * NT * 


kKKKKKK 


NT INPUT MESSAGE (No Trace) 


The 


NT input message atlows the system operator to request a program's 


interpreter to stop tracing and close the trace file. 


The 


The 


format of the NT message is: 


MAKKEKEREKAKEEKKKEKKREKEKKEAKKEKEKKEKREKEEKKKEEKKKEKKERKEKEKKKKKKKKKKKKKKKK 


* * 
* mixsindex NT * 
* * 


RRA K HEHE KK REE RE REKKKKEKEKEKEKEKK KH EKEKEKEAEREKKKKKEKEKKEKKEKRKKKKKKK KK 


NT message is different from the GT 0 message in that the GT 0 


message will not close the trace file. The system operator may request 
a trace again after the NT message has closed the trace file with a GT 
message which wiil open the trace file. 
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OF INPUT MESSAGE ~— (Optional File Response) 


The OF input message is used in response to the NO FILE message. It informs the MCP that the specified 
file is optional and can be bypassed. 


The format of the OF message is: 


mix-index OF 


The OF message indicates that the file being requested is to be bypassed for this execution. Usage is 
restricted for input files that have been declared or label-equated (FILE control word) as OPTIONAL. 


ONL“ Inet Liles 


OK INPUT MESSAGE (Continue Processing) 


The OK message is used by the system operator to direct the MCP to attempt to continue processing a 
program marked as WAITING. 


The format of the OK message is: 


mix-index OK 


The OK message should only be given after the necessary action has been taken to correct the problem that 
caused the program to be placed in WAITING status. 


Examples: 
job-specifier 
job-specifier 
job-specifier 
job-specifier 


job-specifier 


DUPLICATE INPUT FILES... 
DUPLICATE FILE ON DISK... 
NO DISK... 

NO MEMORY ... 

FILE file-identifier NOT PRESENT 


If the corrective action is not taken before the OK message is entered, the original output message is 


repeated. 
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OL INPUT MESSAGE _ (Display Peripheral Status) 
The OL input message allows the system operator to interrogate the status of the system’s peripheral units. 


The format of the OL message is: 


PSR 
OL {unit-mnemonic 
unit-type-code 


The unit-mnemonic option displays the status of a specific unit. 
The unit-type-code option displays the status of all peripherals of the same type. 


Any invalid type unit used in the OL message will cause the MCP to display the following message. 


NULL unit-type-code TABLE 


The PSR option is used to interrogate the status of the pseudo readers on the system. 
Examples: 

CDA NOT READY 

MTC UNLABELED 

DPA LABELED “USER” #123456 


MTA LABELED “MASTER” [123456] 
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OU INPUT MESSAGE — (Specify Output Device) 


The OU input message is a response to direct an output file to a specified output device. 


The format of the OU message is: 


mix-index OU unit-mnemonic 


Example: 


4 OU DPC 


The OU is normally used in response to the ““PUNCH RQD ... or “PRINTER RQD .. .” message to direct 
the file to backup. 
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PB INPUT MESSAGE — (Print/Punch Backup) 


The PB input message allows the system operator to initiate a copy of SYSTEM/BACKUP, that prints or 
punches a disk or tape backup file. 


The PB message has two formats: 


teeter RE nent Aa RR tC reer ee re nts Pet te EINE rennsshReApanenete' 


Format |: 

S/ 
PRT/= 
PRN/= 
PCH/= 


PB [unit-mnemonic] 


Format 2: 


PB [unit-mnemonic] integer [ option-1 [option-2 ] ie| 


If specified, the unit-mnemonic must be a tape (MT) or disk (DC, DK, or DP) device, and indicates to the 
MCP the location of the requested backup file or files. If the unit-mnemonic is omitted, the default disk will 
be assumed (refer to the BD message). 


Format | is used to print or punch a number of backup files with one program. When the =/= option is 
used, all backup files existing on the designated disk or tape at the time the message is entered are printed 
or punched. If both printer and punch backup files exist on the disk, two copies of SYSTEM/BACKUP are 
executed; one copy handles printer files, and the second copy handles punch files. The PRT/= and PCH/= 
options cause the printing or punching of all printer of punch files, respectively, that exist on the designated 
unit. PRN/= is an acceptable equivalent of the PRT/= option. 


NOTE 
When Format 1 is used, no options can be included. 
Format 2 causes the printing or punching of one printer or punch backup file, as specified by the integer. 


When this format is used, options can be included to control the output and action taken by SYSTEM/ 
BACKUP. A detailed description of these options follow: 


Option Function 
COPIES [=] integer Causes SYSTEM/BACKUP to produce integer copies of the speci- 
fied backup file. One copy is the default if this option is not 
specified. 
DOUBLE Causes SYSTEM/BACKUP to double-space the entire printer 


listing, overriding any carriage control specified in the backup file. 


KEY Allows specification of a range of records to be printed or punched. 
A detailed description of the syntax is given below. All records in 
the file will be printed or punched if this option is omitted. 
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PB 
continued 


Option Function 


unit-mnemonic If this option is included, it must specify a printer (LP) or card 
punch (CD or CP), and must be the first option specified following 
the backup file number. It will cause SYSTEM/BACKUP to direct 
its output to the designated unit, if that unit is available. 


RECORD integer-1 [integer-2] Allows specification of a range of records to be printed or punched. 
Output will begin with the physical record specified by integer-1 
(the first record in the backup file is record number 1) and 
continue until the physical record specified by integer-2. If 
integer-2 is omitted, end-of-file is assumed as the terminator. All 
records in the file are printed or punched if this option is omitted. 


SAVE Causes SYSTEM/BACKUP to leave the backup file on disk when 
the file is closed. The file will be removed from disk if this option 
is omitted. Tape backup files are always closed with release, so 
specification of SAVE is unnecessary. 


SINGLE Causes SYSTEM/BACKUP to single-space the entire printer listing, 
overriding any carriage control specified in the backup file. 


The complete syntax for the KEY option follows: 


KEY compiler-name RANGE string-1 string-2 
integer-1 integer-2 EQUAL string-3 


Use of the KEY option allows specification of a range of records to be printed or punched according to 
information within the records themselves (e.g. a sequence number). The portion of each record to be 
compared may be specified, as well as the information that will start and stop the output. 


Integer-1 specifies the column number of the subfield to be used for the compare argument, and integer-2 
specifies the length. Integer-2 must be greater than O and less than 10. 


The compiler-name option causes automatic generation of the proper column number and length pair that 
corresponds to the sequence number field of the output listing produced by the specified compiler. The 
permissible compiler-names that can be used are: BASIC, COBOL, FORTRAN, MIL, NDL, RPG, SDL, 
and UPL. 


The RANGE and EQUAL parameters specify the argument to which the subfield in each record is to be 
compared, and the action to be taken when a “‘true’”’ comparison is detected. The strings can be either an 
integer or an alphanumeric literal enclosed within quote marks. When the comparison arguments are of 
different lengths, an integer string is left-truncated or left zero-filled to the same length as the subfield; an 
alphanumeric literal is right-truncated or right space-filled to the same length as the subfield. 


If EQUAL is specified, printing or punching will begin when an exact comparison is made between the 
subfield and string-3, and will continue until end-of-file is reached. 
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PB 
continued 


If RANGE is specified, printing or punching will begin when an exact comparison is made between the 
subfield and string-1. The printing and punching continues until an exact comparison is made between the 
subfield and string-2, or until end-of-file is reached, whichever occurs first. 


If string-1 is equal to string-2, the entire backup file will be searched. Every record in which the designated 
subfield matches string-1 is printed or punched. 


Since the specified comparisons require an exact match between the string and the subfield, no sequential 
ordering of the backup file is necessary. 
NOTE 
If both the RECORD option and the KEY option are specified in 
the same statement, the comparisons specified by the KEY option 
will be made only within the range of records specified by the 
RECORD option. 
Examples: 
PB 17 LPA SAVE 
PB DCC 4 RECORD 5 
PB MTA =/= 
PB 3 KEY COBOL RANGE 123 567 
PB 2 KEY 7 6 EQUAL “ABC” 


PB 53 RECORD 1.100 DOUBLE SAVE 
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PD INPUT MESSAGE _ (Print Directory) 


The PD input message allows a system operator to request a list of all files on a disk directory or to 
interrogate a disk directory for a specific file(s). 


The PD message has two formats: 


Format 1 dp-id/=/= (removable pack) 
PD == (system pack) 
Format 2 
file-identifier 
PD family-name/= 


dp-id/family-name/= 


The format 1 message will give a complete listing of all files in a disk directory. 
The format 2 message will give a partial listing of the files in a disk directory. 
The family-name/= format will list all files with the specified family-name. 
If the file-identifier is not present in the disk directory the MCP will respond with the message: 
file-identifier NOT IN DIRECTORY 
Examples: 
Does a file named COBOLZ reside on the system pack? 
request: PD COBOLZ 
response: PD =COBOLZ (affirmative response) 
What files reside on the system pack? 


request: PD =/= 


response: PD file-identifier-1 


PD file-identifier-2 


PD Fg ss 
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PD 
| continued 


Does a family-name PAYROLL with a file-identifier QUARTERLY reside on a removable pack called 
MASTER? 

request: PD | MASTER/PAYROLL/QUARTERLY 

response: PD = MASTER/PAYROLL/QUARTERLY 
Do the files ALPHA, BETA, CHARLIE, reside on the system pack? 


request: PD ALPHA, BETA, CHARLIE 


response: PD = ALPHA 


ll 


PD = BETA 


CHARLIE NOT IN DIRECTORY 


PG INPUT MESSAGE _ (Purge) 


The PG message permits the system operator to purge a removable disk cartridge, disk pack, or magnetic 
tape. 


The format of the PG message is: 


PG unit-mnemonic [serial-number ] 


A disk cartridge/pack that is purged will be marked as UNRESTRICTED with its disk pack-id remaining 
unchanged. 


The serial-number is required when purging a disk, and must be a six-digit number matching the serial 
number of the pack being purged. 


Magnetic tape must have a write ring in place in order to be PURGED. 


The serial-number is not used when purging a tape, and the serial number in the tape label will not be 
changed. To assign or change a tape serial number, use the SN message. 


Examples: 
PG DPA 000456 


PG MTC, MTD 
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PM INPUT MESSAGE (Print Memory Dump) 


The PM input message allows a system operator to print the entire contents of memory or single program 
dump file. 


The format of the PM message is: 


A PM by itself will cause the execution of the MCPI/ANALYZER or MCPII/ANALYZER program which 
will analyze and print the contents of SYSTEM/DUMPFILE. (System Memory) 


The “‘integer’’ option will cause the execution of the DUMP/ANALYZER program which will analyze and 
print the contents of DUMPFILE/integer. (Program Memory) 


The programs DUMP/ANALYZER and either MCPI/ANALYZER (MCPI) or MCPII/ANALYZER (MCPII) 
must be located on systems disk to perform a PM message. 


The SAVE option will cause the DUMP/ANALYZER to leave the specified DUMPFILE on disk at EOJ; 
without this option, the DUMPFILE will be removed from disk. 
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PO INPUT MESSAGE (Power Off) 


The PO input message informs the MCP that a removable disk pack or cartridge is to be removed from the 
system. 


The format of the PO message is: 


| PO unit-mnemonic i 


A system pack may not be powered off. 


A PO message entered for a unit that is currently being used will cause the MCP to display the following 
message: . 


unit-mnemonic HAS integer USERS 


A PO message entered for a unit that is not currently in use will cause the message: 
unit mnemonic MAY NOW BE POWERED DOWN 
to be displayed. 


The PO message may be used on a multi-pack file base pack if there are no single-pack files in use at the 
time of the request. 
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PR INPUT MESSAGE — (Change Priority) 


The PR input message allows the system operator to change to priority of a program that is currently in the 
MIX. 


The format of the PR message is: 


mix-index PR [=] integer 


See the PRIORITY Control Instruction Attribute for a further explanation of priority. 
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PS INPUT MESSAGE = (PROD Schedule) 


The PS input message gives the system operator the ability to request that the MCP attempt to execute 
the “‘top”’ entry in the ACTIVE SCHEDULE. 


The format of the PS message is: 


The normal function of the MCP checks the ACTIVE SCHEDULE at each EOJ or when a program is 
scheduled. The PS message will cause the MCP to check the ACTIVE SCHEDULE when the message is 
entered. 
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PW INPUT MESSAGE (Set Program Working Set - MCP I) 


The PW input message is used to set the field PROG.WORKING.SET in the program’s Program Parameter 
Block to the size in bytes of the memory space needed to hold the program’s working set. 


The format of the PW message is: 


blank = 


PW program-identifier 
[=] size-in-bytes 


When the blank = entry is input, the current value of the Program Working Set will be used. When the 
size-in-bytes is specified, the Program Working Set will be set to the value indicated. 


NOTE 


If the Program Working Set is made too large for available memory, the MCP will 
ignore the value assigned. If set too small, the program will run inefficiently. 


The PW message responds by returning the following message. 


PW program-identifier = size-in-bytes 


Therefore the Program Working Set may be interrogated for size by entering this message: 


PW program-identifier = 


Example: 
PW A/B= (Test Size) 


PW A/B = 5000 (Response) 


PW A/B = 4500 (Set Size) 


PW A/B = 4500 (Response) 
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QC INPUT MESSAGE = (Quit Controller) 


The QC input message allows the system operator to bring the NDL-generated Network Controller to 
End-of-Job. 


The format of the QC message is: 


: _ 


There can be only one NDL-generated Network Controller executing on the system. If any additional 
Network Controllers are attempted to be executed the following message will be output: 


NETWORK CONTROLLER ALREADY RUNNING 


After entering the QC message and all activity in the NDL system has stopped, the Network Controller 
issues STOP codes to all attached stations and then goes to End-of-Job. 


If a station for any reason is unable to receive its output messages, the Network Controller waits 
indefinitely. 


With a MCS in the system, the QC message is invalid and its function should be performed within the MCS. 
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QF INPUT MESSAGE (Query File) 


The QF input message allows the system operator to interrogate a program on disk for the status of its 
control attributes. 


The format of the QF message is: 


tt 


QF program-identifier control-attribute-identifier [... ] 


Examples: 
QF A/B CG 


QF A/B FILE LINE BACKUP 
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QP INPUT MESSAGE (Query Program) 


The QP input message allows the system operator to interrogate a program while running on the system for 
the status of its control attributes. 


The format of the QP message is: 


QP job-number control-attribute-identifier [... ] 


Examples: 
QP 14 PRIORITY 


QP 15 CHARGE FREEZE 


PAD = S46. 


we 
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QUEUE MESSAGE (Control QUEUE) 


The QUEUE command allows the user to designate a previcusly opened 
queue file as a control queue. 


The format of the QUEUE command is? 


RHEE KKK KKK KEKE KEEHKKEKKK KEKE KEKE REKEKEKEEKEKEKEKK KKK EK 


| 


* i * 
* QUEUE * 
* namel {/ name2] * 
* QU * 
* * 


PM RR TK TI KE KK EK KM KEKE KKK KKK MKEEEKEEKAEKKKEKEKEKKKKKKKKKKK 


The QUEUE control word may be abbreviated:as QU. 

The control queue provides a mechanism whereby the MCP can communicate 
to a controtling job on behalf of a spawned job» or in response to other 
control card commands which the controlling job may wish to receive. 


This command is allowed only from ZIPs. 
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RB 
RF 


B 
a INPUT MESSAGE (Remove Backup Files) 


The RB or RF input message gives the system operator the ability to remove backup files on disk. 


The format of the RB,.RF message is: 


B integer 
{ ee \ [disk-pack-identifier/] ¢ PRT/= 

PRN/= 
PCH/= 


The integer will remove the backup file specified by the integer. 


The PRT/= and PCH/= options will remove either all print backup files or all punch backup files 
respectively. PRN is equivalent to PRT. . 


The =/= option will remove all backup files from disk. 


The unit-mnemonic option specifies that the backup files to be removed are on the designated removable 
disk. 
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RD INPUT MESSAGE (Remove Pseudo Card Files) 
The RD input message allows the system operator to remove pseudo card files from disk. 


The format of the RD message is: 


integer 


== 
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RL INPUT MESSAGE — (Relabel User Pack) 


The RL input message gives the operator the ability to change the disk-pack-id and/or the type of user 
pack. 


The format of the RL message is: 


R 
RL unit-mnemonic disk-pack-id 
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RM INPUT MESSAGE — (Remove Duplicate Disk File) 


The RM input message allows the system operator to remove a disk file from the disk directory in 
response to a DUPLICATE FILE ON DISK message. 


The format of the RM message is: 


mix-index RM 


The DUPLICATE FILE message is a result of a program trying to close a disk output file with the same 
name as a file already in the directory. This causes the program to go into a wait state. The RM message 
will remove the old file, close the new file, enter it in the directory, and continue processing. 


Example: 


1 RM 
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RN INPUT MESSAGE (Assign Pseudo Readers) 


The RN message is used by the system operator to assign a specific number of pseudo card readers. 
The format of the RN message is: 


RN_ integer 


The RN message can be entered either before or after the creation of pseudo files. 


It is the responsibility of the operator to determine the optimum number of pseudo readers in relation to 
the number of pseudo files to be processed. 


By entering RN 0 (zero) all pseudo card readers will be closed as soon as they are finished processing the 
file that they are presently reading. 


The pseudo card readers may also be closed by performing a Clear/Start. 
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RO INPUT MESSAG"@ (Reset Option) 


The RO message allows the system operator to reset the options used to direct or control some of the MCP 
functions. 


The format of the RO message is: 


RO option-name-1 [,option-name-2] ... 


The MCP replies with a verification that the option has been reset after each RO input message. 


The LOG and CHRG options cannot be reset. The MCP message LOG LOCKED or CHRG LOCKED will be 
displayed when an attempt has been made to reset these options. 


4 


The TO message may be entered to determine which options are set at any given time. The option indicator 
equals one when set and zero when reset. A complete list of the MCP options and their status will be 
displayed. 
Examples: 
RO LIB 
LIB=0 
RO DATE,TIME 


DATE=0 
TIME=0 
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RP INPUT MESSAGE (Ready and Purge) 


The RP message entered by the system operator will set a tape unit in READY status and PURGE the 
tape. 


The format of the RP message is: 


RP unit-mnemonic-1  [,unit-mnemonic-2] ... 


The RP message can be used for tape only. 
Examples: 
RP MTA 


RP MTC, MTD 
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RS INPUT MESSAGE — (Remove Jobs from Schedule) 


The RS input message will allow the system operator to remove a job from the schedule prior to its being 
entered in the MIX for execution. 


The format of the RS message is: 


RS } job-number-1 [,job-number-2] ... 


The RS message can remove one or more jobs from the schedule. 
The schedule number is the number assigned to the job by the MCP when it is entered into the schedule. 


The job-number will be displayed by the MCP when the job is entered into the schedule if the SCHM 
option is set. The WS message will display the jobs in the schedule together with their job-numbers. 


The “=”? option will remove all jobs from the schedule. 


If the requested program(s) are not in the schedule, the MCP will notify the operator that an invalid 
request has been entered. 


Example: 
RS 33 , 34 , 35 , 36 
#33 RS-ED 
#34 RS-ED 
#35 RS-ED 


36 NULL SCHEDULE (job 36 not in schedule) 
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RT INPUT MESSAGE (Remove Multi-Pack File Table) 


The RT input message allows the operator to remove an entry from the multi-pack file table. 


The format of the RT message is: 


RT file-identifier 


Examples. : 
RT USER/A/B 


RT BASEPACK/MASTER/ 
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RY INPUT MESSAGE (Ready Peripheral) 


The RY input message allows the system operator to ready a peripheral unit and make it available to the 
MCP. 


The format of the RY message is: 


RY unit-mnemonic-1 [,unit-mnemonic-2] ... 


Any number of units may be made ready with one RY message. 


When a removable disk cartridge or disk pack is placed on a system, the MCP must be notified of its 
presence with the RY message. 


If the designated unit is not in use and is in the remote status, the RY message causes all exception flags 
maintained by the MCP for the specified unit to be reset. After the unit has been made ready, the MCP 
attempts to read a file label (input devices only). 


Examples: 
RY DPB 


RY MTC 
RY LPA,LPB 
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SD INPUT MESSAGE _ (Assign Additional System Drives) 


The SD input message gives the system operator the ability to assign additional system drives for the MCP. 


The format of the SD message is: 


SD unit-mnemonic _ serial-number 
The SD message, after verification of the serial-number, will PURGE the pack, and add it to the system 
packs already on the system. 


At COLDSTART, there is only one system drive, so additional drives may be added by the SD message. 


Once a system drive has been added to the system, it cannot be removed without performing a 
COLDSTART. 


The following message is displayed when the new system drive is linked to the system. 


unit-mnemonic IS NOW A SYSTEM PACK—CLEAR START REQUIRED 
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SLINPUT MESSAGE (Set LOG) 


The SL input message gives the operator the ability to set the LOG option, and allocate the area required. 


The format of the SL message is: 


SL integer-1 [integer-2] 


The integer-l entry is the size of each area to be assigned to the LOG and cannot be less than 100 or 
greater than 1000 disk segments. 


The integer-2 entry is optional and is the maximum number of areas desired. It must be between 2 and 
105, inclusive. Default is 25. 


The MCP responds with the following message when an SL message has been entered: 
LOG NOW SET—CLEAR START REQUIRED 
If there is insufficient disk space for the first area of the log, the following message will be displayed: 
NO SPACE TO BUILD LOG 
If integer-1 is zero the LOG option will be reset and the log will be transferred (as though a TL message had 
been entered). A new SYSTEM/LOG is not created. 


Examples: 


SL 1000 
SL 250 5 
SL 0 


2-115 


[sn | 


SN INPUT MESSAGE (Assign a Tape Serial Number) 


The SN input message is used to initialize (and purge) a magnetic tape, assigning a volume serial number to 
the tape label. 


The format of the SN message is: 


nn et a ener Ae tN Ne — 


SN unit-mnemonic serial-number 


The SN message initializes a magnetic tape by putting a scratch ANSI label on the tape. Any tape that does 
not contain a valid ANSI label cannot be purged (PG message). This includes both unlabeled tapes and 
those that have the Burroughs standard label. 


The serial-number is normally numeric, but any alphabetic or numeric string up to six digits in length is 


allowed. This serial number is placed in the label, and remains in all labels on the tape (even when purged). 
The serial number can be explicitly changed by another SN message. 


SN MTA 123456 
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SO INPUT MESSAGE _ (Set Option) 


The SO input message allows the system operator to set the options used to direct or control some of the 
MCP functions. 


The format of the SO message is: 


SO option-name-1 [,option-name-2] ... 


The MCP replies with a verification that the option has been set after each SO input message. 


The LOG option cannot be set with an SO message. The MCP message “LOG LOCKED” will be displayed 
when an attempt has been made to set LOG with an SO message. 


The TO input message may be entered to determine which options are set at any given time. The option 


indicator equals one when set and zero when reset. A complete list of the MCP options and their status 
will be displayed. 
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SP INPUT MESSAGE = (Change Schedule Priority) 


The SP input message provides a means for the systern operator to change the schedule priority of a pro- 
gram currently in the schedule. 


The format of the SP message is: 


eerie anc are sets a tN A a A Rt RR I 


SP job-number integer 
The Schedule Priority is separate from the priority of the job when it is in the mix. 
The job-number will identify the program in the schedule that is to be affected by the SP message. 


The integer in the SP message specifies the new priority that will be assigned to the program. Priorities 
may range from zero through 14, where zero is the lowest priority and 14 is the highest priority. 


To change the priority of a program in the schedule with a job-number of 33 to a priority of 7, the follow- 
ing SP message would be used. 


SP 33 7 
This program would be selected from the schedule ahead of the other programs with a lower priority. 
The following message would be displayed in response to the above input message: 


program-name 33 PR = 07 
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SQ INPUT MESSAGE — (Squash Disk) 


The SQ input message permits the system operator to initiate or terminate a “‘disk squash.”” When 
*‘squashing”’ a disk, the MCP attempts to move areas of data to numerically-lower disk addresses in order to 
alleviate disk checkerboarding. 


The format of the SQ message is: 


(SIZE 
SQ unit-mnemonic [integer-1] STOP 
pan integer-2 


The unit-mnemonic specified must be a disk device (DC, DK, or DP). If head-per-track disk (DKx) is 
designated, integer-1 must be used to indicate the electronics unit (EU);.integer-1 is not used with other 
types of disk. 

A disk squash cannot be initiated if there are any jobs in the mix or in either schedule (WAITING or 
ACTIVE). Once the disk squash is initiated, only additional SQ input messages can be entered on the 
console printer. All card readers are inaccessible during the disk squash. 

Both system and user disks can be squashed. With multiple system disks, only one drive or EU can be 
squashed at a time. The MCP automatically produces a KA listing of the specified disk both before and 
after the disk squash; therefore, a line printer must be available. 

If the TILL option is specified, the MCP will terminate the disk squash as soon as integer-2 contiguous 
sectors have been made available. Otherwise, the squash will continue until normal termination or until 
explicitly stopped by the operator with the STOP option. The MCP displays the largest area currently 
available whenever interrogated by the SIZE option. 


When the disk squash is terminated, the MCP displays the size of the largest available area as well as the 
total number of sectors available on the designated disk. 


Examples: 
SQ DPA 
SQ DKB 1 
SQ DCC TILL 5000 
SQ DPB SIZE 
SQ DCA STOP 
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ST INPUT MESSAGE (Suspend Processing) 


The ST input message provides a means for the system operator to temporarily suspend the processing of a 
program in the MIX. 


The format of the ST messgae is: 


mix-index ST 


The mix-index identifies the program to be suspended. 


The MCP will not suspend the program until all I/O operations in progress for that program have been 
completed. 


When the MCP suspends a program, it is rolled-out to disk and the memory it was using is returned to the 
MCP for reallocation. 


A suspended program will retain the mix-index and peripherals assigned to it; the MCP will use this to 
identify the program when referenced by another keyboard input message. 


To restart a program after it has been suspended, the GO message must be used. If for some reason all of the 
conditions necessary for the program to run are not met when the GO message is issued, the MCP will not 
restart the program. 
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SV INPUT MESSAGE (Save Peripheral Units) 


The SV message allows the system operator to make a peripheral unit inaccessible to the MCP until a Clear 
Start operation occurs, or an RY input message is used to ready the unit. 


The format of the SV message is: 


SV unit-mnemonic [,unit-mnemonic] ... 


Any number of peripheral units may be saved with one SV input message. 


When the SV message is entered and the unit is not in use, the specified unit is marked SAVED and “unit- 
mnemonic SAVED” is displayed by the MCP. 


If the unit is in use, the MCP will respond with “‘unit-mnemonic TO BE SAVED” and will save the unit as 
soon as it is no longer being used. 


Example: 


SV LPA 
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SW INPUT MESSAGE (Set Switch) 


The SW input message allows the system operator to set programmatic switches. 


The format of the SW message is: 


rix-index SW wines [=] value 


Programmatic switches may also be set at schedule time by using the SWITCH control statement 
attribute. Refer to Section 2, SWITCH control attribute. 2-¢ ) 


The number must be a decimal digit from zero to nine (0-9) that references the switch to be set. To 
determine what switches are available, the specific language manual for the program for which the switches 
are being set must be referenced. If the “=” option is used, all ten switches are implied (40 bits of 
information). 


The value is the value that the switch or switches will be assigned. 


Examples: 
5 SWI = @F@ 
2 SW8 = 6 
3 SW = @0123456789@ 
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SZ COMAND CSessiton) . 


The 


The 


The 


SZ command is used to apply a session numoer to a control string. 


format of the SZ command is: 


PRK EKER ERE KEK KEKEHKKKKEKKKKKR EK RKKEKEKKKEKEKEKKKEKKKEEKKEKKKEKKKKAKEKSE 


r * 
* SZ integer & 
* , * 


KMART K KEK KKM KEKE EKKK KE KKKK KK EK KEK KKKKKEKKEKHEKEKEEEKEKKEKKKRKKKEKKKKKSE 


SZ command distinguishes commands originating from remote operators 


from those of the local operator. The session number (integer) is 
carried with all zipped control strings. The session number is used 
to relate a set of independent jobs into a logical group which may 
correspond to a physical remote site. 


This command is allowed only from ZIPs. 
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TD INPUT MESSAGE _ (Time and Date) 


The TD input message allows the system operator to request that the MCP type the current values of the 
time and date. 


The format of the TD message is: 


The MCP displays the date and time in the following format: 
DATE = mm/dd/yy TIME = hh:mmi:ss.t 
Where: 
hh — hours 
mm — minutes 


ss — seconds 
t — tenths of seconds 
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TI INPUT MESSAGE (Time Interrogation) 


The TI input message allows the system operator to interrogate the MCP as to the amount of processor time 
the program has used up to the time the interrogation was made. 


The format of the TI message is: 


mix-index TI 


The mix-index identifies the program for which the interrogation was requested. 
The time is given in hours, minutes, seconds, and tenths of seconds. 
Example: 

4TI 


COBOL: A/B = 4 CPU TIME = 00:03:15.7 
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TLINPUT MESSAGE (Transfer LOG) 


The TL input message allows the system operator to transfer the information in the SYSTEM/LOG to 
LOG/ #integer. To print the LOG refer to the LG input message. 


The format of the TL message is: 
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TO INPUT MESSAGE (Display Options) 


The TO input message allows the system operator to interrogate the status of the MCP options. 


The format of the TO message is: 


TO | option-name-1 [,option-name-2] ... 


The TO message entered by itself will display all of the options and their settings. 
A value of zero (QO) indicates a reset (off) condition; a value of one (1) indicates a set (on) condition. 
Example: 


TO LOG, TIME 


LOG = 1 
TIME = 0 
or: 
TO 


BOJ = 0 DATE =1... (lists all options) 


2-126 


TR INPUT MESSAGE _ (Time Change) 
The TR message allows the system operator to change the current value of the time maintained by the MCP. 


The format of the TR message is: 


TR integer 


The time specified by the integer is designated according to a 24-hour clock, and must be four digits in 
length. 


This message is not accepted by the MCP if the value of the integer is greater than 2400 hours. 
Example: | 
Set the time in the MCP to 7:19 P.M. 


TR 1919 
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TS INPUT MESSAGE (Test Switches) 


The TS input message allows the system operator to test the programmatic switches set by the SW 
console message or the SWITCH control statement attribute. 


The format of.the TS message is: 


mix-index TS 


The output of the TS message is in hexadecimal format. 
Example: 


4 TS 


PAYROLL/103 = 4 SWITCHES = @0123456789@ 
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UL INPUT MESSAGE (Assign Unlabeled File) 


The UL message allows the system operator to designate the unit on which a particular unlabeled input file 
is located in response to a ““FILE NOT PRESENT” message from the MCP. 


The format of the UL message is: 


mix-index UL unit-mnemonic [integer] 


The UL message is used only if the unit designated is to be acted on as an unlabeled file. The MCP assumes 
the file on the designated unit is the file requested by the program that caused the ““FILE NOT PRESENT” 

message. ; 
The mix-index must be used to identify the program to which the file is to be assigned. 


If integer is used, the MCP spaces forward “‘integer’’ blocks prior to reading the first data block into the 
object program. Tape marks are read as blocks. This is done at the time the file OPEN is performed. 


Example: 


A program with a mix-index of 1 calling for an unlabeled input tape file could be assigned a tape on 
a unit with the unit-mnemonic of MTA with the following UL message: 


1 ULMTA 


If the first three blocks on the tape are not desired, they can be skipped with the following UL 
message: 


1 UL MTA 3 
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USER INPUT MESSAGE 


The USER command provides a way of invoking the file security mechanism 
anc associated naming convention. 


The format of the USER input message is: 


RK RKKKCKKKKHEKMHKEKKKKK KEKE KEKE KEKE KKK AKEKEKKKE EE KEKE KKEKEKEEKKEKEEEKEKEK 


USER 
(2?) usercode ({/password] 
US 


* * * H ® 
+e * tH 


RRA KEKE KKK EEKKEKEKRKEKEKEKEKKEKEKEREKKEEMKKKEKEHEKKEKEKEKEKKKKKKKKKKKKKK 


The control word USER may be abbreviated as US. 


The USER command causes the MCP to verify the usercode and password 
against the system usercode/password file (created by SYSTEM/MAKEUSER). 
The usercode is applied to any subsequent file name references or any 
files opened during a job executed with a USER command. 
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WD INPUT MESSAGE (Display MCP Date) 
The WD input message permits the system operator to request the current date used by the MCP. 


The format of the WD message is: 
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WM INPUT MESSAGE (Display Current MCP and Interpreter) 


The WM input message allows the system operator to inquire which MCP and Interpreter are currently being 
used since there can be more than one MCP and Interpreter residing on the system pack. 


The format of the WM message is: 


The reply to the WM message is in the following format: 


MCP = mcp-name INTERP = interpreter-name GISMO = gismo-name INIT = initializer-name 
GISMO ALSO CONTAINS: 

segment-name-1 

segment-name-2 


segment-name-n 
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WS INPUT MESSAGE (Display Schedule) 


The WS input message allows the system operator to interrogate what program or programs are currently in 
the schedule and their status. 


The format of the WS message is: 


ws job-number 


The job-number is assigned by the MCP as the program is entered into the schedule. 


The MCP response to the WS message gives the program-name, schedule number, memory required in KB’s, 
program priority, and the length of time the program has been in the schedule. 


Example : 
WS 4 


ALPHA = 4 NEEDS 8 KB PR = 4IN FOR 00:08:37.4 
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WT INPUT MESSAGE (Display MCP Time) 


The WT input message permits the system operator to request the current time used by the MCP. The 
reply is in the twenty-four hour clock format. 


The format of the WT message is: 
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WW INPUT MESSAGE (List Contents of NAME TABLE) 


The WW input message gives the operator the ability to list the different types of system software/ 
firmware in the NAME TABLE. 


The format of the WW message is: 


Ww 
system-software-mnemonic 


See the Clear/Start procedure for an explanation of the system software-mnemonics used in the 
NAME TABLE. 
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WY INPUT MESSAGE _ (Program Status Interrogation) 


The WY message allows the system operator to check the current status of one program or all the 
programs in the MIX. 


The format of the WY message is: 


[mix-index] WY 


The mix-index identifies the program in the MIX that is to be checked and its status displayed on the 
console printer. If the mix-index is omitted the MCP will display the status of every program in the 
MIX. 


If the program is waiting for some type of operator action, the alternatives available to the operator will 
be identified. 


Examples: 
1 WY 
PAYROLL/PAY105=1 IL UL DS--NO FILE “PAYROLL/MASTER” 
WY 
COBOL; LISTER=1 EXECUTING 
DMPALL=2 AX DS--WAITING FOR KEYBOARD INPUT 


USER/ACCPAY/=3 WAITING FOR I/O COMPLETE ON “CARDS” (CRA) 
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XC 
XD 


<1, INPUT MESSAGE 
XD) 


The XC and XD input messages allow the removal of contiguous disk segments from the MCP tables of 
available disk space temporarily (XC) or permanently (XD). 


The format of XC, XD message is: 


XC 
es unit-mnemonic {integer-1 ] interger-2 integer-3 


The unit-mnemonic specified must be a disk device (DC, DK, or DP). If head-per-track disk (DKx) is 
specified, integer-1 must be used to indicate the electronic unit (EU). Integer-1 is not used when other 
types of disk are specified. 


Integer-2 specifies the beginning segment address, and can be expressed in any format. If the operation 
is being performed on a disk cartridge (DCx), and the beginning segment address is not the address the 
first segment in a track, the MCP will automatically adjust it backward to the beginning of the track. 


Integer-3 specifies the number of segments to be removed from use by the MCP. If the operation is 
being performed on a disk cartridge (DCx), the number of segments removed will always be a multiple 
of entire tracks. The MCP will make the necessary adjustments, both in starting address and number 
of segments. 


The disk space to be removed must be available in order to be removed; therefore, if any portion of the 
space is occupied by files or headers, for example, the MCP will reject the request with the message: 


REQUESTED SEGMENTS NOT REMOVED—NOT AVAILABLE 


The requested disk space is permanently removed from use by the XD message. To return the removed 
segments a disk initialization (for disk packs or cartridges) or COLDSTART (for head-per-track disk) is 
required. 


The XC message temporarily removes the disk space from use. The disk space is returned at the next 
CLEAR/START or, for user packs or cartridges, when the disk is powered down (PO message). 


Examples: 


ee 


XC DKA 0 200 1000 
DISK SPACE REMOVED FROM @EE00000C8@ THRU @EE00004AF@ 
XC DCC @46@ 30 


DISK SPACE REMOVED FROM @EA2000040@ THRU @EA200007F@ 


Ja re 
ae a 
7 ‘a 
- { 
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ZQ@ COMMAND (Zip Queue) 


The ZQ command is used to designate a previously opened queue file as 
a control queue used exclusively for schedule messages and data card 
messages. 


r 


» 


The format of the ZQ command is: 


WERE KK KKK KK KK KEKE KKK KKK KKK EKEKEEKEKKKEKEKKKKKKKKaEKKKKKEKKKE KK 


* * 
* ZQ onamel {/name2] * 
* . * 


RE KKE KKK KEKE KEKE KKK KE KEKE KK KEEKEK EK KAKA KEKEKKKKEEKEKAKKKEKKEKKKEKEEKK KK 


The ZQ command is similar to the QUEUE command with the exception that 
the queue specified is used exclusively far schedule messages and data 
card messages. Where the control queue may contain many messages 
concerning jcos» MCP responce te input messages» etcer the zip queue 
will contain only schedule records of jobs zip executed by. the 
controlling programs and the data card label message if a DATA control 
card was encountered in the zippea string. 


This effectively allows the controlling program to be immediately 
aware of the face that a job has been scheduled without having to scan 
through the general control queue for pertinent messages. In general,» 
the cortrol queue is designed for general communications while the zip 
queuve is specifically to be used for job spawning control. 


This cemmand is allowed only from ZIPs. 
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MCP OUTPUT MESSAGES 
General 


The MCP communicates information to the system operator by the console printer. Messages can either 
be originated by the MCP for information and possible operator action, or they can originate from an 
executing program. In either case, the MCP has complete control over all messages. 


All output console messages are indented one space by the MCP, in order for the operator to easily 
distinguish them from input messages. Messages originating from within a program (i.ec., DISPLAY 
messages) are preceded by a percent sign (%) in order to more easily distinguish them from messages 
originated by the MCP concerning the program. 


Syntax 
The paragraphs below outline the syntax used in defining the MCP messages in this section. 


Classification: MCP messages are listed in alphabetical order using the first word of the actual 
message as the key. The job-specifier portion and any “optional” type entries are not 
considered part of the key. 


Job-Specifier: Job-Specifier is simply used to identify the job for which that message is intended. 
The format of the job-specifier is: 


[compiler-name:]: program-name = mix-index . . 
The compiler-name portion is only printed when the executing program is a compilation. 


Terminal-reference: The phrase “‘terminal-reference’”’ following any message indicates that a 
termination message will be printed. Any time this message is printed, the program must 
be DS-ED or DP-ED, except when the TERM option is set causing the program to be 
terminated automatically. 


The format of the terminal-reference message is: 


P = nn, S = nn, D = nn (@—@, @—@, @—@) DS or DP 
or: S=nn, D = nn (@—@, @—@) DS or DP 


NOTE 


There are situations usually occurring when memory is approaching 
saturation that the program-identifiers will be omitted from console 
messages and referenced only by their mix-index number. This is done 
to conserve memory. For example, the following message: 


3 NO MEMORY 
might be used instead of 


A/B/C = 3 NO MEMORY 
MCP Messages 
***1ob-specifier—ABORTED*** 
job-specifier—ACCEPT 
job-specifier-ACCESS PPB TARGET OUT OF RANGE terminal-reference 
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ATTEMPTED TO WRITE OUT OF BOUNDS 

unit-mnemonic ASSIGNED TO SYSTEM USE 

unit-mnemonic AVAILABLE AS OUTPUT 

BACKUP FILE nnnnnn NOT REMOVED—NOT ON DISK 

BACKUP TAPE NOT FOUND—“RY” unit-mnemonic 

BATCH COUNT COMMUNICATE ISSUED WHILE SORTER FLOWING terminal-reference 


job-specifier BEGINNING DATA OVERLAY ADDRESS = nnnn, WHILE BR = nnnn 
terminal-reference 


job-specifier— EO). = job-number PR = nn [integer SYNTAX ERRORS] TIME = hh:mm:ss. 
job-specifier-CANNOT ACCEPT “[IL‘UL‘OF‘FR‘FM‘OU‘OK‘RM‘MR] ”MESSAGE 
CANNOT ACCEPT DATA STATEMENT FROM THE SPO 

unit-mnemonic CANNOT BE OPENED OUTPUT FOR file-identifier 

CANNOT CHANGE PACK-ID OR FAMILY NAMES WITH EQUALS... id’s... 
CANNOT FIND UNIT REQUESTED FOR FN 

CANNOT READ LABEL ON unit-mnemonic 

CANNOT READ THE LABEL ON unit-mnemonic 

CANNOT REMOVE PACK.ID OR FAMILY NAMES WITH = -S file-identifier 
CANNOT SAVE THIS DEVICE unit-mnemonic 

file-identifier CHANGED TO new-file-identifier 

CHAR OR BIT STRING IS INCOMPLETE .... input message .... 

#* *CLEAR/START***B1700 MCPIT MARK nnn.nn mm/dd/yy hh:mm 

** *CLEAR/START REQUIRED 


CLEAR/START REQUIRED—SYSTEM/PRINTCHAIN MISSING 


job-specifier-CONTROL STACK OVERFLOW terminal-reference 
job-specifier—““CONVERT” ERROR terminal-reference 

COULD NOT CHANGE THE MCP 

job-specifier—CPU TIME = hh:mm:ss.t 

CURRENT MCP IS identifier USING interpreter-id 


job-specifier—-DATA OVERLAY RELATIVE DISK ADDRESS = nnnn, WHILE SIZE OF 
AREA = nnnn terminal-reference 
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DECK = nnnn= 50 CHAR 

DECK nann IN USE BY program-name 
** DECK NUMBER nnnn NOT ON DISK 
DEFAULT CHARGE NO. = nnnnnn 


DISK ERROR ON OVLY (2ap | { DISK ADDRESS@nnnn@ \ 
write f FROM ) wemorRY ADDRESS@nnnn@ 


job-specifier—DISK FILE DECLARED SIZE EXCEEDED ON file-identifier terminal-reference 
job-specifier—unit-mnemonic DISK PARITY @nnnn@ 

job-specifier—nnnnDISK SEGMENTS REQUIRED FOR AREA OF file-identifier 
job-specifier—DIVIDE BY ZERO terminal-reference 

**DR PLEASE 

job-specifier-DUPLICATE INPUT FILES file-identifier _ 

END BF | 

END MX 

END PD 


job-specifier—ENDING DATA OVERLAY ADDRESS = nnnn, WHILE BR = nnnn 
terminal-reference 


“=? NOT PERMITTED IN FILE NAME FOLLOWING “FN” 

unit-mnemonic ERROR/pack-id IS [RESTRICTED or INTERCHANGE] PACK 
unit-mnemonic ERROR unit-id 

job-specifier—EVALUATION OR PROGRAM PTR STACK OVERFLOW terminal-reference 
EXECUTE program-name CTRL RCD ERR:... 

job-specifier—EXPONENT OVERFLOW terminal-reference 

job-specifier—-EXPONENT UNDERFLOW terminal-reference 

job-specifier—EXPRESSION OUT OF RANGE terminal-reference 


RELEASE 
PURGE 
REMOVE 
Eee CRUNCH 
job-specifier « OUTPUT FILE file-identifier CLOSED iia 
INPUT/OUTPUT LOCK 
CONDITIONAL 
ROLLOUT 
TERMINATE 
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job-specifier—FILE internal-file-identifier LABELED... REEL nnnnnn NOT PRESENT 


job-specifier—FILE internal-file-identifier NEEDS nnnn BITS TO OPEN, WHICH I COULDN’T 
FIND—“OK” WILL TRY AGAIN, ELSE “DS” 


file name “‘file-identifier’”» REQUESTED BY “FN” NOT FOUND 
FN = “‘internal-file-identifier”’ 

FREE UP SOME DISK AND CLEAR/START 

GOOD MORNING, TODAY IS name-of-day, hh:mm:ss.t ae JLN DT = yy/ddd 
unit-mnemonic HAS nnnn USERS 

unit-mnemonic HAS BEEN PURGED 
job-specifier—unit-mnemonic HOPPER EMPTY 

INVALID BIT CHARACTER-... 

INVALID BIT SPECIFIER—... 

INVALID CHAR COL nn 

INVALID CHARACTER... 

INVALID CHANGE—PACK-IDS DO NOT AGREE.... 
job-specifier—INVALID CASE terminal-reference 
job-specifier—INVALID COMMUNICATE IN USE ROUTINE terminal-reference 
unit-mnemonic INVALID CONTROL CARD 

INVALID DECK NUMBER... 

INVALID ED MESSAGE DECK NUMBER 
job-specifier—INVALID index terminal-reference 

INVALID JOB NUMBER 

INVALID MC-CHARGE OPTION ALREADY SET 

INVALID MIX NUMBER 

INVALID MNEMONIC ... 

job-specifier—-INVALID LINK terminal-reference 
job-specifier—INVALID OPERATOR terminal-reference 
INVALID PACK.ID OR TAPE MNEMONIC FOR PB... 


job-specifier—INVALID PARAM TO VALUE DESC terminal-reference 
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job-specifier—INVALID PARAMETER terminal-reference 
INVALID PG 

job-specifier—INVALID RETURN terminal-reference 
INVALID SD—SERIAL NUMBER REQUIRED 
INVALID SERIAL NUMBER 

INVALID SL—LOG ALREADY SET 
job-specifier—INVALID SUBSCRIPT terminal-reference . 
job-specifier—INVALID SUBSTRING terminal-reference 


INVALID SYNTAX for {CHANGE COMMA IS REQUIRED FOR MORE THAN ONE PREOWE 
REMOVE REMOVE 


unit-mnemonic INVALID TYPE CODE... 

INVALID unit-mnemonic 

INVALID UNIT MNEMONIC FOR FN, MUST BEGIN WITH ALPHA 
“IL” REQUIRES A PARAMETER 

file-identifier IN USE 

job-specifier—-INSUFFICIENT MEMORY TO OPEN file-identifier 
job-specifier IS EXECUTING 

pack-id IS ALREADY A SYSTEM DRIVE 

pack-id IS ANONREMOVABLE SYSTEM PACK OR IS ALREADY OFF LINE 
pack-id IS AN INTERCHANGE PACK 

unit-mnemonic IS NOT A USER PACK 

pack-id IS NOT INITIALIZED 

job-specifier IS NOT STOPPED 


RESTRICTED 


k-id IS 
coe INTERCHANGE 


PACK 


job-specifier IS SUSPENDED 
job-specifier—-INTEGER OVERFLOW terminal-info 


INTRINSIC “‘intrinsic-name’”” REQUESTED BY program-name = job-number IS NOT IN 
DIRECTORY — FS or RS. 


INV OPTION option-name 


unit-emnemonic LABELED.... REEL nnnnnn 
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unit-mnemonic LABELED....[S,R,U, or 1] SERIAL.NO = nnnnnn 


LABELED... 


IN USE BY iob-specifier .. . 
seogouing SE BY job-specifier 


unit-mnemonic 


file-identifier LOAD TERMINATED—DISK ESTIMATE ERROR 
file-identifier LOADED 

unit-mnemonic LOCK OUT 

job-specifier LOCKED DISK FILE file-identifier 

option-name LOCKED 

unit-mnemonic LOCKED 

LOG NOW SET—CLEAR/START REQUIRED 

LOG OPTION NOT SET 

LOG TRANSFER COMPLETE 

pack-id MAY NOW BE POWERED DOWN 

unit-mnemonic MEMORY ACCESS ERROR WAIT TILL UNIT IS RESET AND TRY AGAIN 
job-specifier—unit-mnemonic MEMORY PARITY 

MISSING PARENTHESIS... 

unit-mnemonic MISSING PACK-ID 


MCP RAN OUT OF WORK SPACE WHILE LOOKING FOR interpreter-id WANTED BY 
program-name = job-number 


MODIFY program-name CTRL RCD ERR: ... 
NO SEGMENT DICTIONARY SPACE for program-name = job-number 


job-specifier-NO SPACE AVAILABLE FOR [CODE or DATA] [PAGE nnnn] SEGMENT 
nnnn 


NO SPACE AVAILABLE FOR interpreter-name SOUGHT BY program-name = job-number 
NO SPACE FOR program-name = job-number 


NO SPACE IN INTERPRETER DICTIONARY FOR interpreter-name SOUGHT BY 
program-name = job-number 


**NO SYSTEM DISK FOR PSR DIRECTORY 


**NO USER MEMORY FOR CD 


2-142 


file-identifier NOT A BACKUP FILE—REQUEST IGNORED 
pack-id NOW A SYSTEM DRIVE—CLEAR/START REQUIRED 
unit-mnemonic NOT AVAILABLE 
NOT A DISK PACK—CANNOT RL 
NOT A QUOTE-MARK ... 
“« < FILE-NAME > /=” NOT ALLOWED 
BLACK OR ZERO FIRST NAME 
file-identifier NOT CHANGED— file-identifier ALREADY ON DISK 
NOT ON DISK 
IN USE 
RESTRICTED FILE 
NOT ENOUGH MEMORY FOR CM 
job-specifier-NAME OR VALUE STACK OVERFLOW terminal-reference 
job-specifier—-NEEDS AN AX REPLY 
program-name job-number NEEDS nnnnnnKB PR=nn hh:mm:ss.s 
job-specifier—NO DISK AVAILABLE FOR DUMP 
NO DISK SPACE TO BUILD LOG 
job-specifier—-NO MEMORY AVAILABLE FOR DUMP 
NO MEMORY FOR KA 
**NO MEMORY FOR PSEUDO READER 
**NO MEMORY FOR PSR DATA DIRECTORY (PSR = Pseudo Reader) 


NO OVLY DISK AVL FOR program-name =job-number AMT RQD: nnnn 
SEGMENTS—RS—ED 


NO PRINTER AVAILABLE 

NO PRINTER AVAILABLE FOR KP 

NO PROGRAMS RUNNING 

job-specifier—NO PROVISION FOR I/O ERROR ON file-identifier terminal-reference 
job-specifier-NO PROVISION FOR END OF FILE ON file-identifier terminal-reference 
NO PSEUDO DECKS ON DISKS 

job-specifier—-NO ROOM TO OPEN FILE file-identifier 


file-identifier NOT IN DIRECTORY 
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file-identifier NOT IN DISK DIRECTORY 
“=”? NOT PERMITTED IN PROGRAM NAME FOLLOWING “FN” 
file-identifier NOT LOADED—IN USE BY SYSTEM 


LOCKED 


file-identifier NOT 
REMOVED 


INVALID PACK-ID pack-id 


file-identifier NOT ON DISK 

pack-id NOT ON LINE 

unit-mnemonic NOT READY 

NULL SCHEDULE 

NULL... TABLE 

NUMBER OF PSEUDO READERS CHANGED TO nnnnnn 
unit-mnemonic OFF LINE 

OUT OF MEMORY SPACE 

job-specifier-OUTPUT UNIT NOT AVAILABLE FOR BACKUP 


PARITY ERROR 


— NO RECOVERY 
ACCESS ERROR 


job-specifier—unit-mnemonic 


PM CANNOT FIND DUMPFILE/integer FOR DUMP/ANALYZER 


job-specifier—-POCKET LIGHT COMMUNICATE REQUESTED WHILE SORTER 
FLOWING terminal-reference 


job-specifier—PRIORITY CHANGED TO new-priority-number 
job-specifier—unit-mnemonic PRINT CHECK 

PRINTER NOT READY 

job-specifier—-PROGRAM ABORTED terminal-reference 
job-specifier-PROGRAM IS NOT WAITING SPO INPUT—AX IGNORED 
PSEUDO/nnnnnn NOT ON DISK 

PSEUDO/nnnnnn NOT REMOVED—INUSE 


job-specifier—unit-mnemonic PUNCH CHECK 
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PURGED LABEL 
unit-mnemonic..= file-identifier [REEL nnnnnn] 


UNLABELED 
unit-mnemonic READ CHECK 
job-specifier—-READ OUT OF BOUNDS terminal-reference 
unit-mnemonic RELABELED pack-id tit 


CODE 


job- ifier—REQUESTED { 
job-specifier QU A DATA 


} SEGMENT OF LENGTH ZERO terminal-reference 


job-specifier REQUESTED A CORE SPACE NOT EQUAL TO THE SIZE I JUST COMPUTED 
AS HIS REQUIREMENT—RS—ED MY SIZE = nnnn HIS SIZE = nnnn 


job-specifier-READ REQUESTED ON OUTPUT FILE file-identifier terminal-reference 
program-name REQUESTED BY “FN” NOT IN DIRECTORY 


READ 
program-name REQUESTED ‘ WRITE ON CLOSED FILE 
SEEK 


or REQUIRES THREE OR FOUR CHARACTERS 


device-mnemonic REQUIRED FOR REEL  nnnnnn file-identifier 
message REQUIRES MIX NO. | 

job-number RS-ED 

unit-mnemonic REWINDING 


SAVED 
TO BE SAVED 


unit-mnemonic 
SD REQUIRES NULL MIX 

SCHEDULED: program-name = Job-number PR=nn hh:mm:ss.s 
job-specifier—SEEK REQUESTED ON SERIAL FILE file-identifier terminal-reference 
nnnn SEGS REQ FOR SYSTEM DUMP FILE 

SERIAL NUMBER REQUIRED 


SPACE REQUIRED BEFORE “or@... 
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job-specifier—STACK OVERFLOW terminal-reference 
job-specifier—-SUPERFLUOUS EXIT terminal-reference 
SYSTEM/LOGOUT NOT IN DIRECTORY 

job-specifier-TANK OVERFLOW terminal-reference 

3 DISK SEGMENTS NEEDED FOR SYSTEM/PRINTCHAIN 

THERE ARE NO ENTRIES IN LOG... NO TRANSFERS OCCURRED 
THERE ARE NO RELEVANT BACKUP FILES—PB IGNORED 

*** THERE IS NO BACKUP PRINT OR PUNCH FILE WITH NUMBER nnnnnn [ON PACK-ID] 
job-specifier—unit-mnemonic TIMEOUT @nnnnnn@ 

TOKEN TOO LONG—REQUEST IGNORED .... 

job-specifier-TOO LONG IN USE ROUTINE 

TOO MANY ‘=” IN NAME... TRY AGAIN 

TOO MANY “/”-S IN NAME... TRY AGAIN 


job-specifier—-TRIED TO INITIALIZE A GLOBAL BLOCK LARGER THAN ENTIRE 
STATIC SPACE REQUESTED STATIC = nnnn GLOBAL = nnnn —RS-ED 


SEND TO 


job- ifier—TRIED T 
job-specifier—TR O i ECEIVE FROM 


““program-name” WHICH IS NOT RUNNING 


**TR PLEASE 

job-specifier-UNDEFINED RUN TIME ERROR terminal-reference 
job-specifier—-UNEXPECTED POCKET SELECT terminal-reference 
job-specifier—UNINITIALIZED DATA ITEM terminal-reference 
unit-mnemonic UNIT PURGED 


NOT READY 
job-specifier—unit-mnemonic JAM 
| missorr ) 


UNIT-MNEMONIC MUST START WITH ALPHA 

unit-mnemonic UNLABELED 

pack-id WRITE—LOCKOUT 

job-specifier—-WRITE REQUESTED ON INPUT FILE file-identifier terminal-reference 


job-specifier ZIPPED AN INVALID CONTROL CARD 
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SECTION 3 
SYSTEM SOFTWARE 


DISK CARTRIDGE INITIALIZER 

General 

A disk cartridge must be initialized before it can be used on the system. The purpose of disk initialization 
is threefold. One, it assigns addresses to all segments on the disk. Two, it checks to see what segments, if 
any, are unusable (cannot be read from or written to). Any segment found to have errors will cause the 
entire track in which it resides to be removed from the MASTER AVAILABLE TABLE. If any flaws 
occur in track ZERO or ONE the entire pack is considered faulty and cannot be used on the system. Three, 
skeleton table entries, the disk directory, and available tables, for example, are built and the label is written 
in segment zero. Operation of the DISK CARTRIDGE INITIALIZER is interactive through the console 
printer. 

Operating Instructions 


The DISK CARTRIDGE INITIALIZER program does not operate under the control of the MCP and must 
be loaded and executed through the cassette reader on the control panel, as follows: 


a. Place the DISK CARTRIDGE INITIALIZER cassette in the cassette reader in the control panel. 
The BOT light should be lit at this time. 


b. Place the console printer on-line. 

c. Set the system MODE switch to the TAPE position and press the CLEAR, then START buttons. 
This loads the bootstrap loader from the cassette tape and halts the processor. The L register 
must be equal to @AAAAAAG@ at this time. 


d. Set the system MODE switch to the RUN position and press START (DO NOT PRESS CLEAR). 
This will load and execute the initializer. 


Upon execution of the DISK CARTRIDGE INITIALIZER, the following message is displayed on the con- 
sole printer: 


DISK CARTRIDGE INITIALIZER — MARK level-number > 
The following succession of messages is then displayed, each requiring a response: 
WHICH CARTRIDGE —DC <X> OR LEAVE BLANK TO TERMINATE 
VERIFICATION ONLY? — <YES OR NO> 
ENTER 6 DIGIT SERIAL NUMBER 
ENTER PACK.ID 
ENTER CARTRIDGE TYPE — “U,S,OR RD 
ENTER JULIAN DATE — <YYDDD> 


ENTER OWNERS NAME 
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When initialization and/or verification is complete, the following messages are displayed: 
ID= <PACK.ID> SER#= <integer> <integer) BAD SECTORS 
INITIALIZATION COMPLETE DC <X> 
WHICH CARTRIDGE? — DC <X> OR LEAVE BLANK TO TERMINATE 


At this time, an additional disk cartridge can be initialized or verified, or the program can be terminated 
with a null entry. 


DISK PACK INITIALIZER 

General 

The DISK PACK INITIALIZER program initializes disk packs. All disk packs must be initialized by the 
DISK PACK INITIALIZER program before they can be used by the system software. Addresses and char- 
acter patterns are written into each disk sector. A maximum of five bad sectors per cylinder can be relocated 
into the spare sectors provided. Bad sectors in excess of five per cylinder are removed from the Available 
Table for that pack. (Due to system requirements, six or more bad sectors within the first 64 sectors 
constitute a bad pack and cannot be used.) 

Operating Instructions 


The DISK PACK INITIALIZER does not operate under the control of the MCP, and must be loaded and 
executed through the cassette reader on the system console in the following manner: 


a. Place the DISK PACK INITIALIZER cassette in the cassette reader on the control panel. The 
BOT light must be lit at this time. 


b. Place the console printer on-line. 

c. Set the system MODE switch to the TAPE position and press the CLEAR button. Then press the 
START button. This loads the bootstrap loader from the cassette tape and halts the processor. 
The L register must be equal to @AAAAAA@ at this time. 


d. Set the system MODE switch to the RUN position and press START (Do not press CLEAR). The 
cassette tape will then load. 


After the cassette tape has been read, the following message is displayed on the console printer: 
B 1700 DISK PACK INITIALIZER — MARK level-number> 

When initialization of the pack begins, the following message is displayed: 
INITIALIZATION BEGINS — DP <X> 

After the initialization phase, or if verify only was specified, the following message is displayed: 
VERIFICATION BEGINS — DP <X)¥ 

After a successful initialization and/or verification of the pack, the following message is displayed: 
ID= <PACK.ID) SER#= <NNN> BAD SECTORS 


INITIALIZATION COMPLETE — DP <X> 
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Information is supplied to the DISK PACK INITIALIZER from the card reader. There must be one infor- 
mation card for each disk pack to be initialized. The card deck may optionally contain Marginal-Sector 
card(s) and Dollar-Sign card(s) for each pack to be initialized. A detailed description of each specification 
card follows. 


information Card 


The Information Card supplies identification parameters to the DISK PACK INITIALIZER and has the 
following fixed format: . 


Card Columns Description 
1 Disk drive mnemonic letter (A. . .P) 
2 “V” = Verify; Blank = Initialize and Verify 
3-8 Disk cartridge serial number 
10-19 Label 
21 Type of Cartridge: 
S = System 


U = Unrestricted 
R = Restricted 
23 Julian date (YYDDD) 
29-42 Owners identification 
Marginal-Sector Card 
The Marginal-Sector card is used to specify the addresses of up to 60 sectors to be unconditionally relocated 
by the DISK PACK INITIALIZER program. Addresses must be in decimal (leading zeroes are optional), 
and multiple addresses can appear on as many cards as required. If used, Marginal-Sector cards must 
immediately follow the Information card. Refer to Example 2 below for an example of the use of 
Marginal-Sector cards. 


Dollar-Sign Card 


The Dollar-Sign card allows optional specification of the initialization pattern and the number of verification 
passes. The format follows: 


$ initialization pattern> <verification passes> 
The dollar sign must appear in column one of the card. 
The initialization pattern must be represented in four hexadecimal digits (@OO00@—@FFFF@). If omitted, 


the pattern defaults to @6363@. The verification passes entry (1-10) is optional, and specifies the number 
of verification passes. The default is one pass. 
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Examples Using Input Specification Cards 
The following examples show typical uses of the input specification cards: 
Normal initialization and/or verification with no options specified. 

D 123456 ABC U 75123 JOHN SMITH 

? END 
Example 1 would result in initializing DPD with a pattern of @6363@ and verify one pass. 
Normal initialization and/or verification with Marginal-Sector cards. 

B 123456 ABC U 75123 JOHN SMITH 

98335 18877 

479665 

? END 


Example 2 would result in initializing DPB with a pattern of @6363@, verify one pass, and relocate 
addresses 98335, 18877, and 479665. 


Initialization and/or verification controlled by Dollar-Sign cards. 
D 123456 ABC U 75123 JOHN SMITH 
$ FFFF 
? END 
Example 3 would result in initializing DPD with a pattern of @FFFF@ and verify one pass. 
Initialization and/or verification controlled by Dollar-Sign cards with Marginal-Sector cards. 
D 123456 ABC U 75123 JOHN SMITH 
98385 
$ FFFF 3 
$ 6363 4 
? END 
Example 4 would result in relocating address 98385, initializing the disk with a pattern of 


@FFFF@, verifying three passes, initializing the disk with a pattern of @6363@, and verifying four 
passes. 
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COLDSTART 
General 


The COLDSTART routine is used to load basic system software and firmware to disk. The routine is 
furnished on a cassette tape and is loaded via the control panel cassette reader. 


The following actions are performed by COLDSTART: 


a. Constructs and initializes the disk directory and available tables on the system disk. 
b. Loads the MCP from magnetic tape to system disk. 


c. Loads the SDL Interpreters for both the 1710 and 1720 series of computers from magnetic tape 
to the system disk. 


d. Loads the CSM firmware for both the 1710 and 1720 series of computers from magnetic tape 
to system disk. 


e. Loads the System Initializer from magnetic tape to system disk. 


f. Loads SYSTEM/LOAD.DUMP, FILE/LOADER, and SYSTEM/MEM.DUMP from magnetic 
tape to system disk. . 


Makes appropriate entries in the NAME TABLE for all system software and firmware loaded. 
h. Constructs the COLDSTART VARIABLES on system disk. 


i. Displays a message on the console printer instructing the operator to perform a Clear/Start. 


NOTE 


When a COLDSTART is performed on a system disk that was previously 
in operation, all the files entered in the disk directory are lost and must 
be reconstructed. This is due to the disk directory being initialized and 
cleared by the COLDSTART. 
Procedure 
The COLDSTART procedure is as follows: 
a. Mounta “system” pack on drive O (if not a head-per-track system). 
b. Set MODE switch to TAPE. 
c. Place the COLDSTART cassette in the cassette reader. Cassette is automatically rewound. 


d. Press CLEAR, then START. 


e. Cassette reads a few feet and the system halts. The “‘L”’ register contains @AAAAAA@ at this 
time. 


f. Set MODE switch to RUN, press START. 
g. Cassette will continue to read. If the system HALTS with @ 4 @ in the L register, the cassette has 


a hash total error and must be reloaded. When the cassette has finished loading, the STATE light 
will come on, and COLDSTART will begin execution. 
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During COLDSTART execution one message is displayed requiring action by the system. operator. This 
message and its response is as follows: 


WHERE IS THE MCP—MT (X) Respond with the tape unit with 
the MTx input message. 


The system disk created by COLDSTART is a single system pack configuration, and does not contain a 
LOG. Once the system is running under MCP control, the number of system drives may be increased 
using the SD message, and the LOG option set with the SL message. 

CLEAR/START and MEMORY DUMP PROCEDURE 


General 


A Clear/Start is used by the system operator to restore the system to an operable state. A Clear/Start 
must be performed under any of the following conditions: 


a. System Power-up. 

b. an unscheduled halt. 

c. an uninterruptible system software loop. 

d. the system software/firmware is changed (via CM message). 
A Clear/Start performs the following functions: 

a. Terminates all programs being executed. 

b. Empties the schedule. 

c. Writes correct parity and zeros throughout memory. 


d. Loads the MCP, SDL Interpreter, System Initializer and the Central Service Module (CSM) 
specified by the NAME TABLE entries selected. 


e. Returns control to the MCP. 


If the processor is running at the time a Clear/Start is to be performed, the INTERRUPT switch on the 
console should be used to bring the system to an orderly halt. 


Clear/Start Procedure 
a. Halt processor with the INTERRUPT switch. 
b. Place Clear/Start cassette in cassette reader. 
c. Press CLEAR. 
d. Set MODE switch to TAPE position. 


e. Press START (When tape stops, check the L register for all A’s. At this point enter any 
temporary changes to be made in the T or X registers.) 


f. Set MODE switch to RUN position. 
g. Press START. 


The same Clear/Start program is usable on any system and with either the MCP I or the MCP II. 
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Name Table 


The NAME TABLE is built during COLDSTART and resides on disk. It identifies firmware and system 
software that can be used in the operational environment of the system. 


The operator may select from NAME TABLE different environments for operation. However, not all 
systems will be able to use many of these programs since they are strictly for experimental system software 
development and system software debugging. 


The main advantage of the NAME TABLE method of selecting an operating environment is the ability to 
at all times recover to the standard mode of operation. 


A typical COLDSTART procedure will load and identify for the system the following: 
a. A standard MCP 
b. A SDL Interpreter for both the B 1710 and B 1720 series of computers 
c. ACSM for both the B 1710 and B 1720 series of computers 
d. A System Initializer 
e. SYSTEM/LOAD.DUMP 
f. FILE/LOADER 
g. SYSTEM/MEM.DUMP 


This is enough system software and firmware to begin operations on whatever hardware is available. A sys- 
tem pack may be moved from one system to another and started by merely performing a Clear/Start. 


Operating Environments 


The CM message is used to identify the function of various programs to the system for subsequent usage. 
See the CM input message for the syntax to be used. 


The following list describes the function code or the system software mnemonic and its meaning. 


System 
Software 
NAME TABLE Mnemonic 
Entry Number (Function Code) Meaning 
0 N Standard System Initializer 
1 NE Entry System Initializer 
2 NX Experimental System Initializer 
3 Gl 1710 Central Service Module 
4 G2 1720 Central Service Module 
6 GE Entry Central Service Module 
i GIT 1710 Trace Central Service Module 


System 


Software 
NAME TABLE Mnemonic 
_Entry Number (Function Code) Meaning 
8 G2T 1720 Trace Central Service Module 
10 GET Entry Trace Central Service Module 
11 GX Experimental Central Service Module 
12 I] 1710 MCP Interpreter 
13 12 1720 MCP Interpreter 
14 IE Entry MCP Interpreter 
15 iT 1710 MCP Trace Interpreter 
16 I2T 1720 MCP Trace Interpreter 
17 IET Entry MCP Trace Interpreter 
18 IX Experimental MCP Interpreter 
19 M Standard MCP II 
20 ME Entry MCP (MCP I) 
21 MT Trace MCP 
22 MET Entry Trace MCP 
23 MX Experimental MCP 
24 SD Stand-Alone Memory Dump 
25 SDE Stand-Alone Entry Memory Dump 
26 SDD Stand-Alone Disk Dump 
27 SDL Stand-Alone SDL Program 
28 SIO Stand-Alone I/O Debug 
29 SL Loader for Stand-Alone SDL Program 
30 SK Stand-Alone MIL Program 


The purpose of the CM input message is to identify a file on System Disk to be used for a designated 
function. 


Example: 
CM Mx MCP/XYZ 


The above example makes the file MCP/XYZ the experimental MCP and will be the program executed 
when an experimental MCP is called for. 


Selecting Environments 


With the appropriate files loaded and CM-ed, there are four general environments which can be selected as 
a basis for operation: 


a. Standard MCP (MCP II) 
b. Standard MCP with Trace 
c. Entry MCP (MCP I) 
d. Entry MCP with Trace 
The operator may select one of these by making two choices: 
a. STANDARD vs. ENTRY 
b. TRACE vs. NON-TRACE 


The following input messages are used to make the above choices. 


Input message Description 
CE Use Entry MCP/firmware 
CS Use Standard MCP/firmware 
CT Make Trace Available. 
CN Non-Trace 


A Clear/Start is required to effect any change. The choices become the new basis for operation. They 
remain in effect until they are changed explicitly, but they can be switched on a temporary basis during 
the Clear/Start procedure. 

Temporary Environment Changes 


Operations following a Clear/Start can be tailored to the needs of system programmers by setting the 
following values in the T register. 


Bits on the control panel are numbered from LEFT to RIGHT. 


Bits . Description 
0 Dump Memory 
1 Run a stand-alone program 


(see, below, bits 8-11) 


2 Switch MCPs, I vs. II 

3 Switch TRACE vs. NON-TRACE 

4 Run with experimental MCP 

5 Run with experimental System Initializer 
6 Run with experimental Interpreter 
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Bits Description 


7 Run with experimental CSM 
8-11 When bit 1 is set, the following programs will be run. 
Value Identification 
0 SX 
1 SDD 
2 SIO 
3 SDL, using SL to load with interpreter 


12-23 Must be left zeros 


Another option that can be made during Clear/Start is the designation of the system disk. To override the 
usual Clear/Start selection, load the following values in the X register. 


Bits Value 
16-19 Port 
20-23 Channel 


Memory Dump Procedure 

The memory dump as well as other temporary changes may be accomplished during the Clear/Start 
procedure. Between steps (e) and (f) in the Clear/Start Procedure simply set the proper bits in the appro- 
priate register and continue with the normal Clear/Start procedure. 

The memory dump requires that bit 0 of the T Register be turned on at this time. 


Firmware Detected Errors 


Errors detected during Clear/Start will cause a halt with an error message in the L register identifying 
the error and the program that found it. 


L Register Value 


BitsO-15 | Program Identification 
@ 0000 @ Central Service Module 
@ 0O0F @ SYSTEM/INIT 
@ 0OFO @ CLEAR/START 
@ OF00 @ MEM/DUMP 
L Register Value 
Bits 16-23 Error Description 
@01 @ No device on the designated I/O channel. 
@ 02 @ I/O device on channel is not disk. (See T register.) 
@03 @ Disk is not idle. (See T register for status.) 
@ 04 @ Time-out while waiting for service request. 
@05 @ Bad reference address. (X = good, Y = bad.) 
@ 06 @ Bad status count after service request. (See T register.) 
@07 @ Bad result status from I/O control. (See T register.) 
@ 08 @ Seek time-out (timed by system software). 
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L Register Value 


Bits 16-23 Error Description 

@ 09 @ Memory parity error in I/O descriptor. 

@0A @ Memory parity error in I/O data. 

@ 0B @ Time-out waiting for I/O operation to complete. 

@0C @ Exception condition after 15 retries. (See T register.) 

@ 0D @ Exception on test I/O operation. 

@ 0E @ Designated port and channel is not disk. 

@ OF @ No disk on system. 

@10@ Designated port is invalid. 

@11@ Designated channel is invalid. 

@12@ Not enough memory for this program. 

@ 13 @ Memory parity after CSM overlay. 

@14@ Parity error somewhere in memory. 

@15@ NAME TABLE entry (number in T register) is zero or blank. 
@16@ Memory dumpfile port not equal to 7. 

@17@ Memory dumpfile address equal zero. 

@18 @ Disk address in INITIALIZER IPB equal zero. 

@19@ MCP type field in HINTS is zero. 

@i1A@ Invalid stand-alone program specified. 

@1B@ Stand-alone SDL file not available. 

@1C@ No console printer on system. 
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DISK FILE COPY SW = | foompol file nane(or7 Sf? 


General 


The DISK/COPY program will copy one or more disk files from one disk to another or to another location 
on the same disk. 


Cards are used as input for the DISK/COPY routine. Any number of files may be copied during one 


execution of DISK/COPY. Te Ocnin: ts A ye 4 x Sere 
no@ w < 
DISK/COPY Operating Instructions 


The following figure represents the DISK/COPY control deck. 


? END 
‘ 3 
4 SPEC.CARDS 1 s 
7 ? DATA CARDS 


? EXECUTE 


DISK/COPY 


Figure 3-1. DISK/COPY Control Deck 


Specification Cards 


There may be multiple specification cards processed with a single execution of DISK/COPY, but each 
specification card is limited to one file. 


Specification cards are free-form. Each card must contain two disk file-identifiers with the first file- 
identifier being the file to be copied, and the second file-identifier being the new copy of the file. 


The format for the file-identifiers is the same as used for MCP control cards. See the REMOVE control 
instruction for further syntax explanation. 


If the file-identifier is to be retained when copying to another disk, the new file-identifier may specify only 
the name of the pack-id followed by a slash. 


Examples: 
a. Tocopy file AAA on a systems disk to another location on the systems disk with the name BBB: 


AAA BBB 
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To copy a file AAA on a systems disk to another disk named NEWDISK and retain the 
file-identifier: 


AAA NEWDISK/AAA/ 


Since the file-identifier is not changed in example (b), the same result would be obtained by 
using the following specification card. 


AAA — _NEWDISK/ 
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DMPALL 
General 
The program DMPALL has two separate functions: (1) printing the contents of files, and (2) reproducing 
data from one hardware device to another. Execution may be from either the console printer or card 
reader. 
Printing 
Printing files consist of the following: 
a. Data may be card, magnetic tape, paper tape, or disk. 
b. Any file can be read up to a 1000 bytes per logical record. 


c. Contents can be printed in byte, digit, or combined form. 


d. Printing may begin with a specified record number and terminate after a specified number of 
records are printed. 


Reproducing 
Reproducing files may be executed as follows: 
a. A file may be reproduced from any card, magnetic tape, paper tape, or disk. 
b.  File-identifiers, record lengths, and blocking factors may be changed during the reproduction. 


c. Reproducing may begin with a specified record number and terminate after a specified number 
of records. 


Operating Instructions 


DMPALL executed from the console printer responds with the following three messages: 


DMPALL = mix-index BOJ. 
DMPALL= = mix-index ENTER SPECS. 
DMPALL = mix-index ACCEPT. 


The operator replys to the ACCEPT message by entering an AX message containing the specifications 
needed to perform the DMPALL operation. 


The directory of a LIBRARY tape created by the program SYSTEM/LOAD.DUMP can be either punched 
or printed using the following procedure: 


mix-index AX PD [PUNCH] tape-identifier | 


When PUNCH is specified, the tape directory will be output to cards for use with the program SYSTEM/ 
LOAD.DUMP. With PUNCH omitted, the default print option will list the directory. 
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CARDS 
The DMPALL execute control deck has the following format: 
2? EXECUTE DMPALL FILE SPEC NAME specification-file-identifier; 
? DATA specification-file-identifier 
(specification cards) 
2? END 


A semicolon must terminate the specification string, after which comments may be entered. There may 
be more than one card in a specification card file. 


All specification entries are free form in the first 72 columns of the card, and may be separated by either 


a space or a comma, or a combination thereof. The card file containing the specifications (one per card) 
is loaded to disk, and each specification is executed in turn from there. 


Print Specifications LiS7T < file Mtnre “> A CAD 


The specification string for printing a file is as follows: 


LIST 
LST 
LIST1 file-identifier record-length blocking-factor 
) LST1 
LIST2 
LST2 


[Output-format] [Hardware-type] [SKIP integer] 


INCLUDE a VARIABLE SEARCH tart-position search-argument 
ENE start- - 
INCL pia VARY SEA ; 


If LIST2 or LST2 is specified, the printer listing will double-spaced; otherwise, the printer listing will be 
single-spaced. . 


The file-identifier entry must immediately follow the LIST entry, and is required for all files. The format of 
the file-identifier entry is the same as used MCP control instructions; therefore may consist of from one to 
three separate identifiers separated by slashes. A file-identifier that is entirely numeric or which contains 
special characters must be surrounded by quotes. 


The record-length in bytes must be the first numeric entry following the file-identifier. If omitted, a record- 
length of eighty is assumed. For disk files the record-length used will be that of the file when created. 


~The blocking-factor must be the second numeric entry following the file-identifier. If omitted, a blocking 
factor of one is assumed. For a disk file when both the record length and blocking factor entry are 
omitted, the blocking factor with which the file was created will be used. 
The output-format entry may be specified as: 

a. Alpha: A or ALFA. 

b. Numeric: N, NUM, H, or HEX. 


c. Alphanumeric: When entry is omitted. 
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The hardware-type entry may be one of the following: 
a. Card files: CRD or CARD 
b. Magnetic tape files: MTP or TAPE 
c. Paper tape files: PPT or PAPER 
d. Disk files: DSK, DISK, or the entry may be omitted. 
e. 96-col. card files: C96 or CARD96 
The SKIP integer entry may be entered to begin printing with a specified record as denoted by the integer. 


The INCLUDE or INCL integer entry may be used to specify how many records should be included in the 
printout. 


The VARIABLE or VARY entry may be used to specify tape or disk files having variable length records. 
The SEARCH or SEA entry may be used to specify that printing should begin with the first record 


containing the value of the specified search-argument at the specified start-position (byte-number) in the 
record. The first byte in the record is relative position 1. 


The printed output is headed with the file-identifier, record length, blocking factor, the current date, and 
the time. In addition a printout of a disk file will have the value of the End-of-File pointer in the heading. 
A running record count is printed in the left hand margin. 


Reproducing Specifications 


The reproduction string consists of the following specifications: 
PERFORM 


PFM [Routine-type| input-file-identifier input recordength [Input-blockine factor} 
COPY 


[Pes VARY | Output-file-identifier | Output-record-length ousutdiockine set 


[output blocks-per-area [owroutars] 


Beal INCLUDE SEARCH bole aes 
| VARY SKIP integer | INCL | integer | SEA | start-position 


search-argument 


PERFORM, PFM, or COPY informs DMPALL that media conversion is desired. 


The Routine-type entry may be either in the long-hand or short-hand form. 


3-16 


The long hand form utilizes the names of two of the following media: 
a. Card files: CARD 


b. Magnetic tape files: TAPE 


c. Paper tape files: PAPER Z TOE vice > ms LST 
d. Disk files: DISK or the entry may be omitted. 

/ 
e. 96-col. card: CARD96. for ho re col e's 


f. Binary 80-col. card reproduction: BINBIN 


The short hand form uses a combined abbreviation format. 


OUTPUT DEVICES 


96-col. 
From To | Card | Mag. Tape CARD 


: Card CRDCRD CRDMTP | CRDPPT |CRDDSK | CRDC96 
Mag. Tape MTPCRD MTPMTP | MTPPPT |MTPDSK | MTPC96 
Paper Tape PPTCRD PPTMTP | PPTPPT PPTDSK PPTC96 
Disk DSKCRD DSKMTP | DSKPPT | DSKDSK | DSKC96 

C96CRD 


96-col. card 


C96MTP | C96PPT C96DSK C96C96 


Example: 


To go from card to magnetic tape the short-hand form Routine-type would be CRDMTP. The long- 
hand form would be CARD TO TAPE with the TO being optional. 


The format of input-file-identifier is the same as used in MCP control instructions. 


The input-record-length must be the first numeric entry following the input-file-identifier in bytes. If 
omitted, a record length of eighty is assumed for all files except disk files which will use the record length of 
the file when created. 


The input-blocking-factor must be the second numeric entry following the input-file-identifier. If omitted, 
a blocking factor of one is assumed. For a disk file where both the record length and blocking factor 
entries are omitted, the blocking-factor with which the file was created will be used. 


The VARIABLE or VARY entry may be used after the input-file-identifier entries to indicate that the 
input file will have variable length records, but not variable length output. 


The format of the output-file-identifier is the same as for the input-file-identifier. 
The first numeric entry following the output-file-identifier must be the output-record-length in bytes. If 


omitted, a record length of eighty is assumed unless the input file and the output file are both disk files. 
Then the default output-record-length will be assumed to be the same as the input-record-length. 


The output-blocking-factor must be the second numeric entry following the output-file-identifier. If 
omitted, a blocking-factor of one is assumed unless the input file and the output file are both disk files and 
the output-record-length entry was omitted. Then the default output-blocking-factor will be assumed to be 
the same as the input-blocking-factor. 


The number of blocks.per.area must be the third numeric entry following the output-file-identifier. This 
entry is only applicable to disk files. If omitted, 100 blocks.per.area is assumed unless both the input file 
and the output file are disk files and the record-length, blocking-factor entries were omitted for both the 
input file and the output file. Then the number of blocks.per.area for the input file will be used for the 
output file as well. 


The Output-areas is the number of areas set for the output file. Default is 29; 


The VARIABLE or VARY entry may be used after the output identifier to indicate variable length input 
records with variable length records being produced. 


The SKIP integer entry may be used to skip to a specified record prior to creating the output file. 


The INGEUDE or INCL integer entry may be used to specify how many records should be included in the 
output file. 


The SEARCH or SEA entry may be used to specify that copying should begin with the first record contain- 


ing the value of the specified search-argument at the specified start-position in the record. The first relative 
location in the record is one. . 


Examples: 


a. Keyboard Console Input 


EXECUTE DMPALL 

DMPALL = mix-index BOJ. 

DMPALL = mix-index ENTER SPECS. 
DMPALL = mix-index ACCEPT. 


A response of 
LIST PACKA/PAYROLL/ A SKIP 50 


causes a disk file located on the removable disk PACKA to be printed in alpha format beginning with the 
fiftieth record. 


A response of 


1AX COPY CRDDSK CARD SOURCE 80 2 


causes a card file with the file-identifier of CARD to be written to a disk file, 80 character records, blocked 
2, with a file-identifier of SOURCE. 


A response of 
1AX COPY PROGRAM/B CCC/PROGRAM/B 


causes a disk file PROGRAM/B located on a system disk to be copied to the removable disk CCC with the 
file-identifier PROGRAM/B. The new copy on disk CCC will be an exact copy. Therefore, record length, 
blocking, number of areas, and area size will be the same as the original file. 


b. Card Input 


2? EXECUTE DMPALL FILE SPEC NAME SPECCARDS will allow the operator to enter any num- 
ber of specifications via a card reader. DMPALL will look for a card file with the file-identifier 
SPECCARDS. The specifications will be loaded to disk, and then executed one-at-a-time from 
there. 


2 EXECUTE DMPALL FILE SPEC NAME SPECCARDS; 
? DATA SPECCARDS 
COPY CRDDSK XXX 80 1 DSKFIL 80 1 
LIST DSKFIL A 
? DATA XXX 
(card data deck) 
2? END 


The specifications will cause the card file XXX to be loaded to disk, then listed in alpha format. 
Library Tape Directory 


To print or punch the directory of a library tape, the following specification can be used: 


PD [PUNCH] file-identifier | 


If PUNCH is specified, the directory will be punched into cards, with one file-name to a card. 
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FILE/LOADER 

General 

The purpose of FILE/LOADER is to load card decks to disk punched by the program FILE/PUNCHER. 
The FILE/LOADER card deck consists of the standard EXECUTE control card, a dollar card, an asterisk 
card, the data cards, and the END card. 

Doilar Card 


The dollar card is output by FILE/PUNCHER and identifies the file to be loaded. The dollar card can also 
be modified by the operator to change the name of the file-identifier. 


The format of the FILE/LOADER dollar card is: 


The “‘$’’ must be in column one and the file-identifier being free-form from column 2 through 80. 


Dollar Dollar Card ($$) 

Files produced by the MIL compiler (Micro Implementation Language) must be loaded using the $$ card to 
distinquish them from card files output by FILE/PUNCHER. The asterisk (*) card must not be used when 
using the $$ card. 


Below is the card format produced by the MIL compiler which takes six cards to fill a disk segment. 


Column Description 
1-6 Load address (Relative) 
i Blank 
8-9 Number of bits on card 
10 Blank 
11-70 Data in hexadecimal format (30 Bytes) 
71-72 Blank 
73-80 Card sequence number 


The format of the FILE/LOADER dollar dollar card is: 


a $$ file-identifier | 


Asterisk Card 


The asterisk card is used to input the values for the file which is being loaded to disk. This card is produced 
by FILE/PUNCHER and should not be changed prior to input. When the asterisk card is missing, the card 
file is assumed to be a code file. The asterisk card must not be used when the first card of the file is a dollar 
dollar ($$) card. 
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The format of the FILE/LOADER asterisk card is: 


Column Description 
1 “?? Asterisk Sign 
3 File Type 
1 LOG 
3. Control Deck 
4 Backup Punch 
5 Backup Print 
6 Dump 
7 ~ Interpreter 
8 Code 
9 Data 
5-10 EOF pointer 
12-17 Record Size in bits Right Justified, 
19-20 Records.per.Block Leading Zeros 
22-24 Areas Optional 
26-31 Segments.per.Area 
NOTES 

(1) Ifacode file is being loaded, the asterisk card is optional 
and default values are assumed. 

(2) Ifacode or interpreter file is designated on the asterisk 
card, only the EOF pointer is used. All other fields are 
ignored. If the EOF pointer field is blank, 100 segments 
for the interpreter or 500 segments for the code will be 
used as default values. 

(3) All code and interpreter files will be closed with CRUNCH 
which frees the area not being used for the file. 

Example: 
? EXECUTE FILE/LOADER DATA CARDS 
$ file-identifier 
* |. . (Optional) 
data deck 
$ file-identifier 
TR es 
data deck 
END 
RESPONSE: File-identifier LOADED (Displayed after each load) 


Error Messages 


MISSING “$” IN COLUMN ONE 


The first card of the input deck does not have “‘$”’ in column one. 
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MISSING file-identifier 

The first card of the input deck has a “$” in column one, but is otherwise blank. 
SEQUENCE ERROR FOLLOWING = nnnnnnn--file-identifier NOT LOADED 

The card following the card number specified is out of sequence. 
RECORD.SIZE SPECIFIED nnnn—file-identifier NOT LOADED 
AREAS SPECIFIED = 0 — file-identifier NOT LOADED 


0 — file-identifier NOT LOADED 


RECORDS.BLOCK SPECIFIED 


SEGMENTS.AREA SPECIFIED = 0 — file-identifier NOT LOADED 
EOF.POINTER SPECIFIED = 0 — file-identifier NOT LOADED 
INVALID FILE TYPE SPECIFIED —file-identifier NOT LOADED 
BLOCK SIZE 56 — file-identifier NOT LOADED 
EMPTY DECK~—file-identifier NOT LOADED 

There are no cards following the specification card(s). 


“?? CARD INVALID —file-identifier NOT LOADED 


An asterisk card following a dollar dollar card is invalid. 
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FILE/PUNCHER 

General 

The purpose of FILE/PUNCHER is to output disk files to cards in a hexadecimal format that is acceptable 
as input to FILE/LOADER. The dollar card and the asterisk card used by FILE/LOADER are also output 
when FILE/PUNCHER is executed. 

The file-identifier is supplied to the program by an AX input message. For example: 


EXECUTE FILE/PUNCHER 


FILE/PUNCHER=mix-index ENTER FILE IDENTIFIER 
FILE/PUNCHER=mix-index ACCEPT 


mix-index AX file-identifier (free-form) 


After punching the output file, the program will repeat the above messages and wait for another file-identi- 
fier to be entered. By responding with a blank file-identifier, the program will go to EOJ. 


Below is the card format produced by FILE/PUNCHER which takes five cards to fill a disk segment. 


Column Description 
1-72 Data in hexadecimal format (36 bytes) 
73-80 - Card sequence number 


Error Messages 
file-identifier NOT ON DISK 


The file-identifier requested for output cannot be located by the MCP. 
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SORT 
General 
SORT is a system program that provides a means to invoke one of four sort intrinsics used for sorting or 
merging files of records. Specification cards describe the input and output files, the keys by which the 
file(s) are to be sorted or merged, the sort intrinsic to be used, and the various sort options desired. 
All SORT program reserved words and characters appear in uppercase type throughout the SORT sub- 
section of this publication. A list of the SORT reserved words and characters appears at the end of 
this subsection. 
Sort Intrinsics 
A parameter table is generated by the SORT program and used by one of the four sort intrinsics: 

a. SORT/QSORT 

b. SORT/VSORT 

c. SORT/MERGE 

d. SORT/TAPESORT 


The sort intrinsic does the actual sorting or merging of the file(s) in ascending or descending sequence, 
according to assigned keys, in an optionally user-specified, virtual collating sequence. 


The SORT/QSORT intrinsic uses an inplace disk-sorting technique and can be specified when there is a 
minimum amount of disk space available. The SORT/QSORT intrinsic is invoked when the optional 
INPLACE specification statement is included in the SORT program specification card deck. 


The SORT/VSORT intrinsic is a balanced-merge, vector sort with workfiles on disk, and is the default 
sort intrinsic. 


The SORT/MERGE intrinsic merges from two to eight separate files according to common sets of 
ordered keys. This intrinsic is implicitly specified when a FILE statement containing more than one 
input-part is included in the SORT specification card deck. 

The SORT/TAPESORT intrinsic is an unbalanced-merge, vector sort that uses from three to eight 
magnetic tape files as workfiles. This intrinsic can be specified by including the optional integer > 
TAPESORT statement in the SORT program specification card deck. 

SORT Execution Card Deck 


Figure 3-2 contains an example of a SORT execution card deck. 


The SORT program specification cards contain required and optional statements that are parameters to 
the sort, and are in free-form format, and are described in the following pages. 
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Burroughs Corporation oe ss INTER= OFFICE CORRESPONDENCE 


eee 
Santa Barbara 


Software Activity and T.I.0. 


FROM 
Frank Oliva . 


SUBJECT: Koni 


CORPORATE UNIT 


Computer Systems Group 


DATE: 


March 18, 1976 


DEPT. & LOCATION : 
Software Qualification 


SORT/COLLATE - ADDITIONAL FEATURE FOR 5.1 | 7 a 


A new option has been added to SORT/COLLATE, generating an eight-bit BCL 
translation file. This file has the same format as the other translation 
files; i.e., the file consists of three records, a header, a translation 
table: EBCDIC to eight-bit BCL, and a translation table: eight-bit BCL to 
EBCDIC. '"SBCL8" generates the file. See my October 2, 1975 memo on SORT/ 
COLLATE or the new TRANSLATE TABLE GENERATOR product spec. 


Frank Oliva 
Software Qualification 


3g 


rage eles eagle eee ok ‘ - 3011135 (FORM 41)(REV. 4-67). 


TO: 


oO OR RIN TEL tN U.S. AMERICA 


| Burroughs Corporation 


CORPORATE UNIT : LOCATION : 
Computer Systems Group Santa Barbara 


NAME 


' SUBJECT: 


DEPT. 


SO 


Software Activit 1951976... 


DEPT. & “Garnen 
Dick Vail Software Qualification 


c.c. 


K. Meyers 
INCLUDE/DELETE FUNCTION FOR 6.0 J. Alajoki 


SORTGEN will have syntax for specification of the INCLUDE AND/OR DELETE 

keys which will invoke the function. A total of 10 keys will be allowed. 
Each key may compare up to three characters. AND and OR logic will be pro- 
vided for continuing from one key to the next. Each key may compare a field 
in the record to either a constant contained in the key or to another field. 
in the record. The syntax is: 


INCLUDE [xy] ( Displ. 1 “EQL* ae [Lenctx] ALPHA* ) OR* 
NEQ @ @ UA ec ocee 
DELETE LSS NUMERIC AND 
GTR Displ. 2 UN 
LEQ 
GEQ 
ITEM 1 ITEM 2 
*Default 
Byte 1-8192 1-3 
Digit 1~16384 Default = l 


The displacement values become 0-8191 for byte and 0-16383 for digit when 
stored in the keys. The quotes delimit character literals which may con- 
tain any three characters except the quote and the question mark. The 
signs denote hex literals and may contain only 1-6 hex digits. Character 
literals are left justified with blank fill and truncation on the right. 
Hex literals are right justified with zero fill and truncation on the left. 
All literals are right justified in the KEY.DATA field. SORTGEN will set 
up the key table from the above information. If IN is specified, then 
SORTGEN will perform the function; otherwise, the proper Sort Intrinsic 
will be called. | 


The reserved words, INCLUDE and DELETE, may be used only once, but each 
may be followed by several keys. 


ge £2  S» F735 


EE, 


ae ee 
INTER-OFFICE CORRESPONDENCE 


ftware Qualification = 


FORM 41( REV, 4° &7! 


G. A. Hammond, Manager 
January 19, 1976 
Page 2 


The key table format is: 


OL DELETE.KEYS (10) BIT (48) 


02 KEY.TYPE BIT(1) 0O = INC 1 = DEL 
02 LOGIC.TYPE BIT(1) O-= OR 1 = AND 
02 DATA.TYPE BIT(1) O = DATA 1 = FIELD DESC. 
02 LENGTH.TYPE BIT(1) 0O-= DIGIT 1 = BYTE 
02 COMPARE.TYPE BIT(4) 
% GTR= 1 LSS =2 NEQ=3 EQL=4 GEQ=5 LEQ = 6 
02 KEY.LENGTH BIT(2) 
02 KEY.DISPL.1 BIT(14) 
02 KEY.DATA BIT(24) 
03 FILLER BIT(10) 
03 KEY.DISPL.2 BIT(14) 


An S-op will be written to handle the comparing of the keys and records. 
It will have two operands and return a bit one = one if the record is to 
be deleted. The SDL syntax is: 


| < EXP > < EXP > 
IF SORT.DELETE(RECORD| ADR|, DELETE.KEYS) THEN 


DELETE RECORD 


Dick Vail 
Software Qualification 


jg 


? END 
OPTION CARDS 


FILE IN 
? DATA CARDS 


? EXECUTE SORT 


Figure 3-2. SORT Execution Card Deck 


FILE Statement 
The FILE statement is comprised of the reserved word FILE followed by at least one input-part (a descrip- 


tion of the input file(s)) and only one (a description of the output file) output-part. The FILE statement is 
required in any set of SORT specifications, and has the following format: 


FILE input-part [input-part]... output-part 


INPUT-PART 


The input-part of the FILE statement describes an input file to be merged or sorted, and has the following 
format: 


IN file-identifier 


records-per-area) record-size [blocking-factor 
an ( per-area) l g ; 


DEFAULT 


PACK (records-per-area) 
CARD 
(( \ CARDS 


PAPER record-size [ blocking-factor] 


EVEN 


V (maximum-block-size) 
ae My tastes 


PURGE 
oe) eee | VARIABLE 
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File-Identifier 
File-identifiers are the standard B 1700 file format with the exception that any element (disk-pack-id, 
multi-file-id, or file-id) containing one or more non-alphanumeric characters, except the period, must be 
enclosed in quotation marks. 
Example: 

PACK1/WORK.FILE/‘‘#00000002” 
File-identifiers can contain any valid character except the question mark or quote mark. 


Device-Id 


The device-id denotes the hardware type of the device associated with the input file. The allowable 
designations are as follows: 


Device-Id Hardware Type 
DISK Any disk 
PACK Disk pack only 
CARD Card reader 
CARDS Card reader 
PAPER Paper tape reader 
TAPE Any tape 
TAPE (parity-specifier) 7-track tape 


Parity-Specifier 

Seven track tape is implicitly specified by the inclusion of a parity-specifier enclosed in parentheses 
following the tape device-id. ODD or O specifies odd parity, binary mode; EVEN or E specifies even parity 
with BCL translation. 

Records-Per-Area 


When the input file is located on disk, and the DEFAULT option is not used, the number of records-per-area 
must be specified and enclosed in parentheses. 


Record-Size 


The record-size is the actual size in bytes (characters) of the records to be sorted, and is a required entry 
except where the DEFAULT option is specified. 


Blocking-Factor 


The blocking-factor is optional and specifies the number of logical records in a block. When the blocking- 
factor is omitted, the default blocking-factor of one (1) applies. 


Default 


If the input file is on disk, the user may specify DEFAULT, which causes the SORT program to obtain the 
input file specifications (records-per-area, record-size, and blocking-factor) from the disk file header. 
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Purge 


If this option is specified, one of the following will occur when the sort intrinsic has finished reading the 
input file. 


a. If the input file is a disk file, it will be removed from the disk directory. 
b. If the input file is a magnetic tape file, the tape will be purged. 
Multi 


The MULTI option allows a user to sort a multi-pack disk file. If MULTI is specified on the input-part of 
the FILE statement, it must also be specified in the output-part. 


Variable 


The VARIABLE or V option allows the user to sort a file of variable length records. When V is specified, 

a maximum-block-size must be included. The default, when VARIABLE is specified, is equal to record-size. 
The workfile record size is fixed, and is equal to the size of the largest record specified in the input-part of 
the FILE statement. 


Variable length records cannot be sorted with the INPLACE sorting technique. 
OUTPUT-PART 


The output-part of the FILE statement describes the sorted or merged file created by the sort intrinsic, and 
has the following format: 


OUT file-identifier 


DISK ‘ieein record-size —_— 


DEFAULT 


PACK (records-per-area)\ 
CARD 
CARDS 


PAPER 
prea record-size [blocking-factor] 


( V_ (maximum-block-size) ) 
| VARIABLE = 


The elements of the output-part have the same relative function to the output file as the elements of the 
input-part have to the input file, with the exceptions described in the Device-Id and Default paragraphs 
below: 
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Device-Id 


The device-id denotes the hardware type of the device associated with the output file. The allowable 
designations are as follows: 


Device-Id Hardware Type 
DISK Any disk 
PACK Disk pack only 
CARD Card punch 
CARDS Card punch 
PAPER Paper tape punch 
PRINTER Line printer 
TAPE 9-track tape 
TAPE (parity-specifier) 7-track tape 


Default 


The DEFAULT option can be specified for the output file only if DEFAULT is also specified for the input 
file. This option causes the records-per-area, record-size, and blocking-factor of the output file to be 
identical to those found in the input file disk header. DEFAULT cannot be specified when the SORT/ 
MERGE intrinsic is invoked. 


KEY Statement 


The KEY statement defines the field(s) within a record by which the record is to be sorted or merged. The 
KEY statement is required in any set of SORT program specifications, and has the following format: 


KEY ASCENDING ALPHA 
VA 
KEYS A NUMERIC 
(key-location key-length ae a 
FIELD DESCENDING 
FIELDS D 


Sree | eeeee 


Jere arte att pe I 


Multiple key descriptions are allows and must be enclosed in parentheses. The first key is the major Key, 
and any additional keys are minor keys of successive, decreasing significance. Each minor key specified is 
subordinate to its predecessor. 


The maximum number of keys permitted is 30 unsigned keys, or 15 signed Keys, or any combination of 


signed and unsigned keys not exceeding 30, where each unsigned key counts as one and each signed key 
counts as two. 
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KEY-LOCATION 


The key-location specifies the relative position of the most significant byte or digit (alphanumeric or 
numeric) of the field including the sign, if any, from the beginning of the record. 


The first byte or digit of a record is considered as relative position one. The position is referred to in the 
number of units applicable to the data type for that key, thereby permitting different data types to appear 
within the same record. 


Additional information and descriptions of key-location and position will be found in the following 
subsections titled ALPHA or UA and NUMERIC or UN. 


KEY-LENGTH 


The key-length specifies the number of significant bytes or digits in the key, including the sign where 
applicable. The length of a key cannot exceed 511 bytes or 1023 digits. 


ASCENDING OR A 


ASCENDING or A is the default condition, but can be specified if desired. The file is arranged with the 
record having the smallest major key appearing first in the output file, followed by records with 
successively equal or larger keys. 


DESCENDING OR D 


Specifying DESCENDING or D results in the file being arranged with the record having the largest major 
key appearing first in the output file, followed by records with successively equal or smaller keys. 


ALPHA OR UA 


ALPHA or UA (unsigned alphanumeric) indicates that the data is alphanumeric, and the key-location of the 
field is counted in 8-bit units from the beginning of the record. Alphanumeric is the default when no data 
type is specified. 


NUMERIC OR UN 


NUMERIC or UN (unsigned numeric) indicates that the data is 4-bit numeric, and the relative position of 
the field is counted in 4-bit units. 


SA 


SA (signed alphanumeric) indicates that the data is alphanumeric and that some, or all of the keys can 
contain a minus sign. For alphanumeric data, a minus sign is represented by a hexadecimal D in the most 
significant four bits of the first byte of the key. 


SN 


SN (signed numeric) indicates that the data is 4-bit numeric and that some or all of the keys can contain a 
minus sign. The minus sign is represented as a hexadecimal D in the first digit of the key. 


SORT Option Statements 
The SORT program option statements have the following functions: 


a. Specifying information about the input file, such as the number of records in the file or the bias 
(explained below) of the file. _ 


b. Controlling the configuration or operation of the sort by using such options as MEMORY, 
INPLACE, TAGSORT, and RESTART. 
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c. Causing optional operations to be performed before, during, or after the sort execution. 
NOPRINT, SYNTAX, SEQUENCE, TIMING, ZIP, and COLLATE are examples of this type of 
function. 

Each of the SORT program option statements is discussed in detail in the following paragraphs. 


BIAS 


The BIAS statement is used to indicate to the sort program the degree of ordering of the input file in 
relation to the specified key(s). The estimate is used to optimize sort execution. 


The word BIAS must be followed by a number within the range of zero (0) to ninety-nine (99), where 
fifty (50) indicates completely random order and is the default if BIAS is not specified. Zero (0) indicates 
that the file is in reverse order from the sequence desired. A ninety-seven (97) indicates that the file is 
almost in the desired sequence. 
Example: 

BIAS 60% 
The percent sign (%) is optional. 
The bias of a file can be determined by specifying the SEQUENCE statement. 
The BIAS option is not applicable for the INPLACE sort (SORT/QSORT). 
integer» RECORDS 


This option can be used to optimize sort operation by supplying an estimate of the total number of records 
in the input file(s). If this option is omitted, the default is 20,000 records. 


Example: 
12500 RECORDS 
MEMORY 


The MEMORY or ME option can be used to allocate more memory to the sort than the 8000 bytes assigned 
by default. 


Increasing the memory available to the sort is the most significant means of increasing sort efficiency, up to 
an optimum sort memory size. The optimum sort memory size is dependent of many factors, but is 
usually 25 percent less than system memory size. The maximum sort memory size that can be specified is 
125,000 bytes; 18,500 bytes for INPLACE sort. 
Example: 

MEMORY 24000 
INPLACE 
This option can be advantageous when only a minimum amount of disk space is available for sorting. The 
INPLACE sort requires work file space equal to the input file space, unless the input and output file 


identifiers are the same. In that case, no work file space is required, but the input file is overlaid by the 
output file during the sorting process. 
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TAGSORT 


The TAGSORT option provides a means of sorting a file and creating an output file containing indices that 
point to the relative locations of records within the original file. The input file remains intact. 


Input files can originate from any allowable hardware device type, but must reside on disk when using the 
file of indices to access the actual records. 


The output file, referred to as the tagfile, must be defined as four characters per record, because it will 
consist of eight numeric-digit decimal numbers as indices that point to the records in the input file. 


TAGSORT is not an allowable option when the SORT/QSORT, SORT/TAPESORT, or SORT/MERGE 
intrinsics are invoked. 


Access to the input file is provided by using the tagfile as follows: 


a. With COBOL the specified access method is RANDOM and the tagfile record is used as the 
ACTUAL KEY. 


b. With RPG the specified access method is INDEXED and the relative record number is used as 
delivered in the tagfile to directly (DIRECT) access the original file. 


TAGSEARCH 


Specifying TAGSEARCH causes a TAGSORT to be performed, and a resultant sorted file of indices is used 
to build an output record file that is sorted. Beyond an undetermined number of records, TAGSEARCH 
can greatly increase overall sorting speed when compared with the other sorting methods available. 


integer» TAPESORT 


The SORT/TAPESORT intrinsic is invoked when integer > TAPESORT is specified. The number of 
workfiles on magnetic tape can range from three to eight and is specified by Cinteger>. 


The workfiles are opened on whatever tape units are available. If tape output is requested, the first tape 
unit accessed as a workfile is of the same hardware type as specified for the output file. The sort algorithm 
causes this tape unit to be exhausted of data records on the merge pass that precedes the final merge pass, 
thereby making that tape unit available to receive the sorted output file. 


All writing of workfile tapes is done in a forward direction, and all reading of workfile tapes is done in 
reverse direction; therefore, multiple tape reels are not allowed for any individual workfile. The user must 
use workfile tape reels of sufficient size to hold the original input file. For multiple reel input files, each 
tape reel can be sorted separately, and the resultant output files can then be merged using the SORT/ 
MERGE intrinsic. 
The following example specifies that five workfiles are to be used for TAPESORT: 

5 TAPESORT 
RESTART 
If a TAPESORT is terminated abnormally, it can be restarted by inserting a RESTART job-number » 


statement into the SORT specification card deck, and then re-executing SORT. The sort intrinsic 
repositions the workfiles and restarts the program at a point following the last completed pass. 
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The job-number specified must be the job-number assigned to the sort intrinsic at the time of the failure. 
The job-number is also included in the labels of the workfile tapes. 


Example : 
RESTART 1259 
NOPRINT 


The NOPRINT option can be used to inhibit the printing of the SORT specifications on the line printer, 
and must be the first entry in the SORT specification deck. 


Ween 
The TIMING option is not affected by the use of the NOPRINT option. 
SYNTAX 


The SYNTAX option is used when the SORT specification cards are to be checked for errors only. The 
sort intrinsic is not executed, even when no errors are detected in the specification cards. 


SEQUENCE 


The SEQUENCE option checks the sequence of the input file according to the specified key(s). The 
number of records in the file and the bias are printed on the sort specification listing. 


If the NOPRINT option is used, the number of records and the number of sequence errors are displayed on 
the console printer. The bias may be calculated as follows: 


BIAS = ((Number of sequence errors / Number of records) X 100) - 1 
The sort intrinsic is por invoked when SEQUENCE is specified. 
TIMING 


The TIMING option can be specified when the SORT/VSORT intrinsic is used, and provides the following 
information: 


a. Distribute, Merge, and Final Merge Vector Size (VECTOR) in records. 

b. Workfile blocking factor (BLOCK). 

c. Workfile records-per-area (DISKRPA). 
The above information is useful for debugging purposes. 
The TIMING option is not affected by the use of the NOPRINT option. 
ZIP 
The ZIP statement contains the reserved word ZIP followed by a zip-string that is enclosed in parentheses. 
The zip-string is passed to the MCP upon successful completion of the sort. The zip-string cannot contain 
embedded right parentheses or question marks, and is limited in length to 100 characters. 


ZIP (EX A/B AFTER SORT FILE DISK NAME C/D) 


The SORT specifications can contain only one ZIP statement. 
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COLLATE 
General 


The COLLATE option invokes the optional, virtual collating-sequence capability according to a user- 
specified collate file. The collate file can be used to specify a new or unique collating sequence, or to 

retain the standard collating sequence with the exception of certain characters being interchanged or made 
equal in rank. This option permits the alteration of the sequence in which records are sorted or merged by 
any of the sort intrinsics. Alteration of the collating sequence may be desired for foreign alphabets or when 
converting from one processing system to another. 


The format of the COLLATE statement consists of the reserved word COLLATE followed by a file-name 
enclosed in parentheses. The file-name is subject to the constraints described under the heading File- 
Identifier of the FILE statement subsection. 


Example: 

COLLATE (PACK2/TRANS.FILE/“‘#003”’) 
The COLLATE option affects only those sort keys that are declared unsigned alpha (UA). All other sort 
keys are sorted in the hardware collating sequence of @00@ through @FF®@, which is also the default 
collating sequence if no collate file is specified. 
Functional Description 
When the COLLATE option is specified, the MCP interface verifies that the collate file is on disk before 
processing. If it is not present, the user is directed to load the file by a console printer message. The MCP 
verifies the header information prior to opening the collate file to insure that the file consists of two 
256-byte records in a single-area file; if not, a message is displayed and the SORT program is discontinued. 
The sort or merge intrinsic brings the first record of the collate file into memory and, as the key(s) are 
extracted from each record, the keys which are declared unsigned alpha are processed through a translation 


operation before being passed to the sort or merge intrinsic comparison logic. 


During the final merge phase of the sort intrinsics, the second record of the collate file is used to restore 
records to their original values. 


For information pertaining to the creation of collate files, refer to the subsection titled COLLATE FILE 
GENERATOR. 


Comments 


Comments may be interspersed between SORT statements, but must not contain level 1 SORT reserved 
words. ae 
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SORT Reserved Words And Characters 


A list of level 1 SORT reserved words follows. The reserved words in this list cannot be used in comments. 


ME TAGSEARCH 
MEMORY TAGSORT 
BIAS TAPESORT 
NOPRINT TIMING 
FIELD TRANS 
FIELDS PARTITION 
FILE PASSPARAM WAIT 
GENERATE RECORDS ZIP 
1 RESTART 
IDENT 
INPLACE SEQUENCE 
SYNTAX 
KEY 
KEYS 


The words and characters in the following list are reserved only within the scope of one or more of the 
level 1 reserved words in the preceding list. 


( 
) E PRINTER 
EVEN PURGE 
% 
/ IDENT SA 

IN SN 
A 
ALPHA MULTI TAPE 
ASCENDING 

NUMERIC UA 
CARD UN 
CARDS O 

ODD Vv 
D OUT VARIABLE 
DEFAULT 
DESCENDING PACK 
DISK PAPER 


COLLATE FILE GENERATOR 

General 

The SORT/COLLATE program accepts input in the form of language statements described in this 
subsection, and generates a collate file on disk with a specified file-name. The collate file is then used by 
the sort intrinsic during the execution of a sort or merge that includes the COLLATE option. The collate 
file consists of two 256-byte records on disk. The first record of the file is used to collate during input to 
the distribute phase of the sort. The second record is used during output from the final merge pass. 
Execution Deck 


Figure 3-3 illustrates a SORT/COLLATE execution card deck consisting of specification cards and control 
cards. . 
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? DA CARDS 


? EXECUTE 
SORT/COLLATE 


Figure 3-3. SORT/COLLATE Execution Card Deck 


The specification cards contain statements that describe the collating sequence desired by the user, and are 
in free-form format in columns 1 through 71. The statements are checked for syntax errors, and if none 
are found a collate table file is produced. A detailed description of the specification statements and their 
functions follow. 


Specification Statements 
GENERAL 


There are four specification statements used to specify a collate file. The four statements are $ IDNT, 
$ NUMR, $ ALFA, and $ SEQN, and have the following format. 


$ ALFA ch-1 ch-2 [ ch-3 ch-4 ] 


hex-5 [hex-6] ties 
uO hex-7 - hex-8 [hex-9 anal | | vee 


$ NUMR hex-1 hex-2 [hex-3 hex-4] | f . \ | 


[$ IDNT file-name ] 


$ IDNT 


The $ IDNT statement is optional and provides the user with a means to name the collate file being created 
by the SORT/COLLATE program. The file-name must be in accordance with standard B 1700 conventions 
for naming files. If the $ IDNT statement is not included, a default multi-file-id of ““COLLATE”’ is assigned 
to the file produced, and the file is placed on system disk. 


$ NUMR 


The $ NUMR statement is used to specify a number of deviations from the standard collating sequence of 
@00@ through @FF@. This statement uses pairs of hexadecimal characters to indicate a replacement of 
standard collating position. In the syntax format shown above, the character represented by hex-1 would 
collate as hex-2, and hex-4 would replace hex-3 in the collating sequence. As many pairs of characters as 
necessary can be represented to achieve the desired collating sequence. The $ NUMR statement is particu- 
larly useful when dealing with characters that cannot be represented graphically. 


Example: 


$ NUMR 0040 OE3E 
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In the above example, @00@ would collate as @40@ and @0E@ would collate as @3E@. 
The $ NUMR statement can be used alone or in conjunction with the $ ALFA statement. 
$ ALFA 


The $ ALFA statement is similar in function to the $ NUMR statement, with the exception that the 
representations are in the form of graphic characters. This method is more convenient for those characters 
that can be represented graphically. 


Example: 
™ ~~ § ALFA AB ([ 
In the example, A will collate as B and left parenthesis will collate as left bracket. 


When using either or both the $ NUMR and $ ALFA options, any characters not specifically mentioned 
retain their standard position in the collating sequence. For this reason, characters can either explicitly or 
implicitly be made to collate alike. When that is the case, the only way to restore the transmuted charac- 
ters is to see that either TAGSORT or TAGSEARCH is specified in the sort specifications. Refer to the 
subsection titled SORT for additional information.. 


If a character appears more than once on the left side of a pair of characters in a $ NUMR or $ ALFA 
statement, the last appearance takes precedence in establishing its position in the collating sequence. 


$ SEQN 


The $ SEQN statement is a means of specifying a new collating sequence where a string of 2-digit hexadeci- 
mal character representations are used to describe each of the 256 character positions of the collate file. 
Each hexadecimal entry corresponds to a table position, beginning with @00@ and continuing through 
@FF@. Thus, the first character represented collates as @00@, the second as @01@, and so forth. If any 
portion of this hexadecimal string is in an ascending or descending contiguous form, the string can be 
represented as the first and last elements of the contiguous portion, separated by a hyphen. In this manner, 
the string of 2-digit hexadecimal characters 00 01 02 03 04 05 06 07 08 09 could be represented as 00-09, 
and the string 09 08 07 06 05 04 03 02 01 could be represented as 09-01. 


The $ SEQN statement cannot be used in conjunction with either the $ NUMR or $ ALFA statements. 


COBOL CROSS REFERENCE UTILITY PROGRAM (COBOL/XREF) 

General 

The COBOL Cross Reference Utility Program accepts as input a syntactically correct COBOL source 
program, and depending on the option selected, outputs a cross reference listing, or a program source 
listing only, or both a cross reference and a program source listing. 


Operating Instructions 


The source program may reside on disk, magnetic tape, or punched cards. The figure below is an example____. : 


of a COBOL/XREF execution card deck. 
(OPTION CARD) | 


? DATA CARDS 


? EXECUTE COBOL/XREF 


Figure 3-4. COBOL/XREF Execution Deck 


Option Cards 


The option entry specifies the location of the source medium and the output desired. Below is the format of 
the COBOL/XREF option card. 


col. 1 ~ col. 7 


[option] [C] 


The option entry must begin in column 1. 


The letter C denotes that the COBOL COPY verb is used within the source program. C, when used, must be 
in column 7. Requested library files must reside in the disk directory. The library sequence numbers within 
a source program are indicated by a L to the left of the sequence number. 

The options and their descriptions are as follows: 


CARD The input source program is punched cards. Produces a cross reference listing. 


CARD is the default input. If the option entry is omitted the input is assumed to 
be cards. 
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CDLIST The input source program is punched cards. Produces both a source program listing 
and a cross reference. 


DISK The input source program having a file identifier COBOLW/SOURCE resides on disk. 
Produces a cross reference listing. 

DKLIST The input source program having a file identifier of COBOLW/SOURCE resides on disk. 
Produces both a program source listing and a cross reference. 

LISTCD The input source program is punched cards. Produces a source program listing only. 

LISTDK The input source program is on disk. Produces a source program listing only. 

LISTTP The input source program having a file identifier of SOLT is on magnetic tape. Produces 


asource program listing only. 


TAPE The input source program having a file identifier of SOLT is on magnetic tape. Produces 
a cross reference listing. 


TPLIST The input source program having a file identifier of SOLT is on magnetic tape. Produces 
both a source program and cross reference listing. 


Internal File Names 


External File 


Identifiers ee Identifiers Description 
CARDS CARDS Input Source Cards 
TAPES SOLT Input Source Tape 
DISKS COBOLW/SOURCE* Input Source Disk 
CBXPRT XREFER Printer Output 


*Refer to the COBOL Compiler Option NEW for the creation of this file. 


Card: 2? EXECUTE COBOL/XREF 
? DATA CARDS 
CARD C 
(source deck) 


? END 


3-38 


Disk: ? EXECUTE COBOL/XREF 
? DATA CARDS 
DISK 
2? END 
NOTE 


If more than one cross reference file could exist, the FILE 
statement must be used to make each file identifier unique. 


? EXECUTE COBOL/XREF 

? DATA CARDS 

TAPE 

? END 
Certain options of the COBOL/XREF program are controlled by programmatic switches entered by the 
system operator. Refer to the SW control instruction attribute and the SW INPUT MESSAGE keyboard 


input message for details. The options and the programmatic switches and values required to control the 
options follow: 


SW 0 Do not cross reference literals. 

Swi 1 Cross reference literals. 

SWw2 0 Vertical spacing for line printer is to be 6 lines per inch, 56 lines per page. 
SW2 1 Vertical spacing for line printer is to be 8 lines per inch, 76 lines per page. 
SW3 0 No copy files required. 

SW3 1 Copy files required. 

SWs 0 CARD. 

SW5 1 TAPE. 

SWs5 Zz DISK. 

SW5 3 TPLIST. 

SW5 4 DKLIST. 

SW5 > LISTTP. 

SW5 6 LISTDK. 

SW6 0 Double space. 

SW6 1 Single space. 
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LOG/CONVERSION 

General 

The LOG/CONVERSION program extracts information from the file LOG/#<n} and creates a new file in 
COBOL/RPG readable format. The new file is named NEW.LOG/#<n), where n is an eight-digit number 
corresponding to the eight-digit number of the LOG/#<n) file. 

Execution 

Before the LOG/CONVERSION program can be executed, the SYSTEM/LOG file must be transferred to 
the LOG/#<n) file with either the LG or TL system Control Instruction. The number (n) of the LOG/#<n> 
file to be converted is entered with an ACCEPT message. 


NEW.LOG/#<n> File Format 


The NEW.LOG/#<n) file created by the LOG/CONVERSION program can contain the following three 
types of records: 


a. Clear/Start record -- one for each Clear/Start performed on the system since the last LOG 
transfer. 


b. Program Parameter Block (PPB) record — one for each program scheduled or executed. 


c. File Parameter Block (FPB) record — one for each file declared in each program. The FPB 
record(s) follow the PPB record to which they are associated. 


Each record type is 180 bytes. 
The NEW.LOG/#¢integer> file is unblocked. 


Additional information concerning the format of the Clear/Start record, Program Parameter Block record, 
and File Parameter Block record is provided in Tables 4-1, 4-2, and 4-3. 


Table 4-1. Clear/Start Record Format 


DATA 
FIELD NAME TYPE FORMAT OR VALUE 


1 = Clear/Start Record 


Record Type 

Filler 

MCP Family Name 
MCP File Name 

Filler 

Interpreter Family Name 
Interpreter File Name 
MCP Version Date 
Main Memory Size 
Clear/Start Year 
Clear/Start Julian Day 
Clear/Start Time 
Filler 


MMDDYY 
Size in bits 


Counter value 


Z2AAAAAPPrrrHr Kr Kr A!YN 
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The DATA TYPE column in the tables contains a letter indicating whether the data is alphanumeric or 
numeric. The letter A represents alphanumeric data or eight-bit characters. The letter N represents signed 
numeric, 4-bit digits. For signed numeric fields, the FIELD SIZE indicator includes the sign as part of the 
field length. 


Table 4-2. Program Parameter Block Record Format 


FIELD DATA 
FIELD NAME SIZE TYPE FORMAT OR VALUE 


2 = PPB Record 


Record Type Zz 
Job Number 

Program Pack-ID 
Program Family Name 


Program File Name 
Interpreter Pack-ID 
Interpreter Family Name 
Interpreter File Name 
Execute Priority 


Static Memory Size in bits 
Dynamic Memory Size in bits 
Total Memory Size in bits 


Largest Code Segment Size in bits 
Number of Files Declared 
Charge Number 

Schedule Priority 

Virtual Disk 


Execute Type 


Size in segments 


ZAZAAAA™!YAAAYNANANANPSPeKHKrPKrPP-yYAA!YW 


1 = Execute 

2 =.Compile and Go 

3 = Compile for Syntax 

4 = Compile to Library 

5 = Compile and Save 

6 = Ex of Compile & Go 
7 = Ex of Compile & Save 


0 = Normal EOJ 

1 = DS-ed 

2 = Program Error 

3 = Aborted (Clear/Start) 


Year Compiled 


Julian Day Compiled 
Time Compiled System counter value 
Mix Number 
Schedule Year 
Schedule Julian Day 
Schedule Time 

BOJ Year 

BOJ Julian Day 
BOJ Time 


System counter value 


oh ROR A ROP A 
2222424242422 2 


System counter value 
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Table 4-2. Program Parameter Block Record Format (Cont) 


FIELD NAME FORMAT OR VALUE 


EOJ Year 


EOJ Julian Day 

EOJ Time System counter value 
Processor Time System counter value 
Object Pack-id (Compilations only) 
Object Family Name (Compilations only) 
Object File Name (Compilations only) 


Filler 


FIELD NAME 


DATA 
TYPE FORMAT OR VALUE 


Record Type 3 = FPB Record 
Job Number 

File Number 
Internal File Name 
Pack-id 

Family Name 

File Name 


Hardware Type 


Z2ZPrrrr Z2ZaZa 


000 = Invalid device 

001 = 96-Col. punch 

002 = 80-Col. punch 

003 = 96-Col. reader/punch 
004 = 96-Col. MFCU 

005 = 96-Col. reader/punch/printer 
006 =-Paper tape reader 

007 = Paper tape reader 

008 = Printer 

009 = Invalid device 

010 = MICR reader/sorter 

011 = Head-per-track disk 

012 = Head-per-track disk 

013 = Disk cartridge (DCC-2) 
014 = Disk cartridge (DCC-1) 
015 = Disk pack 

016 = Disk pack or cartridge 
017 = Disk 

018 = 96-Col. punch/printer 
019 = 96-Col. reader 

020 = Paper tape punch 

021 = 80-Col. reader 

022 = Console printer (SPO) 
023 = Invalid device 

024 = 9-Track mag. tape (NRZ) 
025 = 7-Track mag. tape (NRZ) 


3-42 


Table 4-3. File Parameter Block Record Format (Cont) 


FORMAT OR VALUE 


026 = 9-Track mag. tape (PE) 
027 = Any 9-track mag. tape 
028 = Invalid device 

029 = Invalid device 

030 = Cassette 


Number of Buffers N 
Record Size N Size in bits 
Records Per Block N 
Maximum Block Size N Size in bits (variable length records only) 
Save Factor N 
Access Type N O = Serial 
1 = Random (disk files only) 
Number of Areas (Disk files only) 
Blocks Per Area (Disk files only) 


Last time opened System counter value 


First time opened System counter value 
Record Count 

Block Count 

Number of Opens and Closes 
Cumulative Time Open System counter value 
Number of Errors 


Filler 


N 
N 
N 
N 
N 
N 
N 
N 
N 
N 


COBOL Record Format 


The following are COBOL declarations that show the format of the Clear/Start, PPB, and FPB records in the 
NEW.LOG/# integer) file when utilizing the output of the LOG/CONVERSION program. 


Format of Clear/Start Record: 


01 CLEAR-START-RECORD. 


02 CS-REC-TYPE PCS9 CMP. 
02 CS-MCP-NAME PC X(30). 

02 CS-INTERP-NAME PC X(30). 

02 CS-VERSION-DATE PC X(6). 

02 CS-S-MEM-SIZE _ PC S99) CMP. 
02 CS-YEAR PC S9(3) CMP. 
02 CS-JDAY PC $9(3) CMP. 
02 CS-TIME PC S9(7) CMP. 


Format of PPB Record: 


01 PPB-RECORD. 


02 PPB-REC-TYPE PCS9 CMP. 
02 PPB-JOB-NUM PC S9(7) CMP. 
02 PR-NAME PC X(30). 
02 PR-INTERP-NAME PC X(30). 
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02 PR-PRIORITY PC §9(3) CMP. 
02 PR-STATIC-CORE PC S9(9) CMP. 
02 PR-DYNAMIC-CORE PC S9(9) CMP. 
02 PR-TOTAL-CORE PC S9(9) CMP. 
02 PR-BIGGEST-SEG PC S9(9) CMP. 
02 PR-FILES PC S9(3) CMP. 
02 PR-CHARGE-NUMBER PC S9(9) CMP. 
02 PR-SCHED-PRIORITY PC S9(3) CMP. 
02 PR-VIRTUAL-DISK PC S9(9) CMP. 
02 PR-EXECUTE-TYPE PC S9 CMP. 
02 PR-EOJ-TYPE PCS9 ~~ CMP. 
02 PR-YEAR-COMPILED PC §9(3) CMP. 
02 PR-JDAY-COMPILED PC S9(3) CMP. 
02 PR-TIME-COMPILED PC S9(7) CMP. 
02 PR-MY-MIX PC §9(3) CMP. 
02 PR-SCHED-YEAR PC $9(3) CMP. 
02 PR-SCHED-JDAY PC 89(3) CMP. 
02 PR-SCHED-TIME PC S9(7) CMP. 
02 PR-BOJ-YEAR PC $9(3) CMP. 
02 PR-BOJ-JDAY PC S§9(3) CMP. 
02 PR-BOJ-TIME PC S9(7) CMP. 
02 PR-EOJ-YEAR PC S$9(3) CMP. 
02 PR-EOJ-JDAY PC 89(3) CMP. 
02 PR-EOJ-TIME PC S9(7) CMP. 
02 PR-PROCESS-TIME PC S9(9) CMP. 
02 PR-OBJECT-NAME PC X(30). 
Format of FPB Record: 
01 FPB-RECORD. 

02 FPB-REC-TYPE PC S9 = CMP. 
02 FPB-JOB-NUM PC S9(7) CMP. 
02 FILE-NUM PC 89(3) CMP. 
02 FP-FILE-NAME PC X(10). 

02 FP-NAMES PC X(30). 

02 FP-HDWR PC §9(3) CMP. 
02 FP-BUFFERS PC S9(9) CMP. 
02 FP-RECORD-SIZE PC S9(9) CMP. 
02 FP-RECORDS-PER-BLOCK PC $9(9) CMP. 
02 FP-MAX-BLOCK-SIZE PC S9(9) CMP. 
02 FP-SAVE PC S9(9) CMP. 
02 FP-ACCESS PC S9 CMP. 
02 FP-AREAS PC S89(5) CMP. 
02 FP-BLOCKS-AREA PC $9(9) CMP. 
02 FP-OPEN PC S9(9) CMP. 
02 FP-1ST-OPEN PC S89(9) CMP. 
02 FP-RECORD-COUNT PC S$9(9) CMP. 
02 FP-BLOCK-COUNT PC S9(9) CMP. 


02 FP-NO-OPENS-AND-CLOSES PC $9(7) CMP. 
02 FP-CUMULATIVE PC S9(9) CMP. 
02 FP-ERRORS PC S9(9) CMP. 


RPG Record Format 


The following are RPG declarations that show the format of the Clear/Start, PPB, and FPB records in the 
NEW.LOG/#<integer) file when utilizing the output of the LOG/CONVERSION program. 
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Format of Clear/Start Record: 


LOGFILE NS _ Ol 1 Di 
P 1 1ORCTYP!1 
2 31 MCP 
32 61 INTERP 
62 67 VERSON 


P 68 720MEMSIZ 
P 73 740CSYR 
P 75 760CSDA 
Py 77 800CSTI 

Format of PPB Record: 

NS 02 1 D2 

P 1 1ORCTYP2 
P 2 50JOBNUM 


6 35 PRNAME 
36 65 INTPNA 
66 670PRIOR 
68 720STCORE 
73, 770DYCORE 
78 820TOCORE 
83. 870BIGSEG 
88 890FILES 
90 940CHARGE 
95 960SCHDPR 
97 1010VIRDSK 
102 1020EXTYPE 
103 1030EOSJTYP 
104 2050YRCOMP 
1070DACOMP 
108 1110TICOMP 
112 1130MIX 
114 1150SCHYR 
116 1170SCHDA 
118 1210SCHTI 
122 1230BOJYR 
124 1250BOJDA 
126 1290BOJTI 
130 1310EOJYR 
132 1330EOJDA 
134 1370EOJTI 
138 1420PROCTI 
143 172 OBJNAM 


ne Bin~ Ma Bao Bao Ba ew ee a Bao a~ es ee in in? a ne ew ee ee 
—y 
© 
ON 


Format of FPB Record: 


NS 03 1 D3 

1 1ORCTYP3 
2 S50JBNUM 
6 7OFILNUM 
8 
18 


met 


17 INTNAM 

47 EXTNAM 
48 490HDWR 
50 S40BUFFS 
590RECSIZ 
60 640RECBLK 
65 690MAXBLK 
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Pg tD 
wn 
wa 


70 740SAVE 

75  750ACCESS 
76 780AREAS 
79 830BLKARE 
84 8800PEN 

89 930FRSTOP 
94 980RECCNT 
99 1030BLKCNT 
P 104 1070NOOPCL 
P 108 1120CUMUL 
P 113 1170ERR 


aw aM Ba~Ba~ ia Be~ ia”) 
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DISK/DUMP 

General 

DISK/DUMP provides the capability of copying data from disk packs to disk packs, disk cartridges to disk 
packs, and disk cartridges to disk cartridges (except 200 TPI to 100 TPI cartridges). The label is first 
checked for validity, and then the data is copied on a sector-for-sector basis. For drive zero system disks 
and user disks, termination of the dump occurs beyond the end of valid data, thereby reducing run time in 
many cases. All input and output specifications are entered from the console printer. When the number of 
input errors exceeds 10, the user can specify the number of retries desired on an ‘‘as-occurs”’ basis. If more 
than 10 output errors occur on a given area, DISK/DUMP is terminated. 

Operating Instructions 


DISK/DUMP does not operate under MCP control, and must be loaded from the cassette reader of the 
system console. Execute DISK/DUMP in the following manner: 


a. Place the DISK/DUMP cassette in the cassette reader. The BOT light must be lit at this time. 

b. Place the console printer on-line. 

c. Set the system MODE switch to the TAPE position, press CLEAR, then START. This procedure 
loads the bootstrap loader from the cassette tape and halts the processor. The L register must be 


equal to @AAAAAA@ at this time. 


d. Set the MODE switch to the RUN position, press START. (Do not press the CLEAR button.) 
This loads the DISK/DUMP program. 


When the cassette tape has been read, DISK/DUMP begins operation with the following message displayed 
on the console printer: 


DISK DUMP MARK Clevel-number> 
ENTER INPUT DRIVE - <DC? or DP?> 

After a correct response, the following message is displayed: 
ENTER OUTPUT DRIVE - <DC? or DP?> 


After a correct response, the data on the disk is copied and compared. Upon completion, without errors, 
the following message is displayed: 


DUMP COMPLETE FROM <input drive mnemonic> TO <output drive mnemonic> 
ENTER INPUT DRIVE - <DC? or DP?> OR BLANK TO TERMINATE 


If the END OF MESSAGE is pressed at this time, DISK/DUMP terminates and the following message is 
displayed: 


END DISK DUMP 
The following error messages can occur during execution. 
Error Messages 


a. DISK ERROR - RESULT IN “T” (Observe T register to determine type of error. Press START 
for retry). 
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DISK NOT READY <input or output drive mnemonic> CORRECT AND HIT START 


PARITY ERR N <input drive mnemonic> ENTER DESIRED NUMBER OF RETRIES OR 
BLANK TO RESTART 


TIMEOUT ON <input drive mnemonic) ENTER DESIRED NUMBER OF RETRIES OR BLANK 
TO RESTART 


INVALID RESPONSE - TRY AGAIN 

I/O ERROR <input or output drive mnemonic> <disk address> RESULT = <result> 
Gnteger> RETRIES ON PARITY 

<integer> RETRIES ON TIMEOUT 

TEMP TABLE FILLED <input drive mnemonic) (Clear/Start this pack and try again). 
COMPARE ERROR Gdisk address> HIT START TO RETRY 

INPUT SIZE LARGER THAN OUTPUT 


NO CART OR PACKS ON SYSTEM 


3-48 


SECTION 4 
PROGRAM PRODUCTS 


COMPILERS 


Compilers generate executable code from a programmer’s source statements. Each compiler has various 
options and operationai techniques which affect its output. The following pages discuss each compiler and 
its individual operating procedures. 


The COMPILE card, DATA card, and the Label equate (FILE) cards are standard for all compilers and 
are not discussed in detail for each compiler concerned. See the Control Instruction section for their 
particular usage and syntax. 


REPORT PROGRAM GENERATOR 

General 

The Report Program Generator (RPG) enables the user to obtain comprehensive reports from existing 
files with a minimum time involved in source coding. An object program produced from RPG source 
coding is in the RPG S-Language format. 

Compilation Card Deck 

A program written in Burroughs RPG, called a source program, is accepted as input by the RPG compiler. 
The compiler has two major functions: (1) verify all syntax rules outlined in the RPG Program Manual, 


and (2) convert the source program language into RPG S-Language which is then ready for execution. 


The program generated by the RPG compiler is executed under control of the MCP using the RPG 
interpreter. 


Following is an example of an RPG compilation deck. 


H CONTROL CARD 
? DATA RPG/CARD 


FILE STATEMENTS 
OPTIONA 


? COMPILE 


$ DOLLAR CARD 


Figure 4-1. RPG Compilation Deck 
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Dollar Card Specifications 


Dollar Card Specifications allow the RPG Compiler to accommodate various extensions to other 
manufacturers RPG and RPG II languages, which cannot be handled on the other specification forms. 
Dollar Cards also allow certain compiler-control options to be set or reset during compilation. 


Dollar cards may appear anywhere within the source deck, as required. Only one option can be entered on 
a card and must be in the following format: 


Columns Description 
1-5 Page and Line Sequence Number 
6 This field may be left blank or contain the form type to align with the 
associated form that the $ option was inserted in. 
7 A $ sign must appear in this field. 
8 This field is used to specify that the option entered in the KEY WORD 


field is set ON or OFF. (Blank = ON, N = OFF). 


9-14 KEY WORD: This field is used to name the option that is to be used. 
The option must be left-justified. 


15-24 VALUE: This field is used to specify a value to be associated with the 
option. All values in alphanumeric form must be left-justified, numeric 
form must be right-justified. 


25-74 COMMENTS: This field is available for comments and documentary 
remarks. 
75-80 Program Name 


RPG Extensions 


The following options may appear only within the file description specifications, and must immediately 
precede the specification line describing the file to which they apply. 


NOTE 


None of the following operations may be “‘reset’’. 


PACKID Specifies the pack name of a disk file. Similar to § FAMILY and $ FILEID, default of 
blank dp-id name and the MCP will assume systems pack. This entry should be included 
to ensure correct handling of files by the MCP. 


FAMILY Specifies the external family name (MFID) associated with the file. The VALUE 
field contains the name which is one to ten characters, left-justified. 


FILEID Specifies the external file identification (FID) associated with the file. The VALUE 
field contains the name which is one to ten characters, left-justified. 


AREAS Specifies the maximum number of areas to be allocated for the file (disk files only). 


The VALUE field contains an integral value, 1 to 105, right-justified, leading zeros 
optional. The default value assigned is 40, unless specified otherwise. 
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RPERA 


OPEN 
CLOSE 
AAOPEN 


ONEPAK 
CYL 
DRIVE 


REFORM 


REORG 


Specifies the maximum number of logical records that will be written in each disk 
area. The VALUE field contains an integral value, right-justified, leading zeros optional. 
The default value assigned is 500 unless specified otherwise. 


Exnlicit open allows for all files to be opened at Beginning-of-Job. Default is an 
implicit open when the files are actually called for. 


Explicit close allows all input serial files to remain opened until End-of-Job. Default 
is the implicit close of files at End-of-File. 


Is a file option used to set a bit in the MCP file parameter block and allocate 
all disk space areas at the beginning of the program. 


Specifies that this particular file must be contained on one disk. 
Allocates file areas starting on an integral cylinder boundary. 


Allocates a physical drive to that particular file. VALUE field must be 0-15. Option 
may not be reset and is not related to PACKID. 


Input and update disk files are assumed to have the block and record length 

declared on the file header unless the $§ REFORM option is used. However, on input or 
update chained indexed file specifications “‘data keys in core” option, it may be 
desirable to also use $ REFORM to indicate to the compiler that it may juggle the 
blocking factor to optimize the speed of chaining. Under this condition, the blocking- 
record-length specified on the File Description Specifications must be the same as when 
the file was outputted. This combination will produce the fastest chaining possible. 


Specifies a specialized method of sorting indexed files will be invoked at End-of-Job. 
The REORG feature only sorts the additions and then merges them, in place, into the 
master file. This method of sorting should decrease the sort time and the temporary 
disk area required. The VALUE field contains the external file identifier of the indexed 
file including disk pack-id. 


NONEPACK 


File may be multipack. 


Compiler-Directing Options 


LIST 


LOGIC 


MAP 


NAMES 


Specifies that the compiler produce a single spaced output listing of the source 
statements with the error or warning messages. This option is set ‘‘on”’ by default. 
Resetting to “off”? will not inhibit the errors or warning messages from printing. 


Specifies that the compiler produce a single-spaced listing of each source specification 
line followed immediately by an intermediate code used to generate RPG-S code. 

The listing is produced after the NAMES listing (if the NAMES option is set), and 
does not include addresses or bit configurations, but only the opcodes and logical 
operands of the program. 


Specifies that the compiler produce a single-spaced listing detailing the program’s 
memory utilization. The MAP listing is produced after the LOGIC listing (if the 
LOGIC option is set). 


Specifies that the compiler is to produce a single-spaced listing of all assigned indicators 
file names, and field names. The attributes associated with each file and field are also 
listed. The NAMES listing is produced immediately after the normal source input 
listing. . 


RSIGN 


SEG 


SUPR 


XMAP 


STACK 


BAZBON 


ZBINIT 


XREF 


PARMAP 


Indicates to the compiler, the location of the sign in numeric data items. When set, 

all signs are assumed to be right-justified; when reset, all signs are assumed to be 
left-justified. This option may be set and reset at different points in the Input and 
Output-Format Specifications, allowing different fields to have different sign positions. 
If the option is used, it will override the sign position specified in the Control Card 
Specifications. 


Orders the compiler to begin placing code in an overlayable segment identified by the 
integer in the VALUE field (right-justified, between 0 and 7 inclusive). Segmentation 
is an automatic function of the RPG compiler and optimized for its best uage. 

When the SEG option is used, automatic segmentation is not suppressed. 


Specifies that the Compiler is to suppress all warning messages from the source pro- 
gram listing. (Error messages still print.) 


Specifies that the compiler print a single-spaced listing of all the code generated, 
complete with actual bit configurations and addresses. Combined with the listing 
produced by the LOGIC option, complete information about the generated code of 
the program is available. The XMAP listing is produced after the MAP listing if the 
MAP option is set. 


Due to infrequent stack overflow conditions during program execution, the user may 
now change the stack size of the resultant program. This should only be used when a 
STACK overflow condition has occurred. The default stack size is 313 bits which will 
allow 8 entries in the stack. To increase the stack size add 39 bits, for each additional 
stack entry, to the default size of 313. 


This specifies that if an indicator is assigned to a field to test for ZERO or BLANK in 
the Input or Calculation Specifications and the same field is used in the Output 
Specifications with a BLANK AFTER designation, that indicator will be turned ON 
after the field is blanked during the output operations. Should a N (not) be specified 
in column 8 the indicator will be turned OFF, overriding the original RPG I or 

RPG II specifications. 


This specifies that all ZERO BLANK indicators are initialized ON at Beginning-of-Job 
or if a N (not) is specified in column 8 they will be initialized OFF regardless of the 
specifications for RPG II or RPG I. 


The XREF option must be placed at the beginning of the RPG source program, prior 
to the first File Specification and prior to H card if present. This option allows the 
RPGXRF file to be created during compilation for use as input to the RPG/XREF 
program. At the completion of the compilation it is necessary to manually execute 
the RPG/XREF program in order to obtain the cross reference listing. 


Produces a single-spaced listing of the compiler-generated paragraph names, source 
statement numbers, and actual segment displacements of the emitted code. This 
listing may be used to relate to the LOGIC listing. 


Internal File Names 


The RPG Compiler’s internal file-identifiers and external file-identifiers for use in file statement are as 
follows: 


External Description 


Internal 


Source output listing to the line printer. 


LINE RPG/LIST 


SOURCE Input file from the card reader. 


RPG/CARD 


TABCRD Input file for TABLES from the card reader. 


RPG/VECTOR 


RPG Internal File Names 
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COBOL COMPILER 

General 

The COBOL compiler is designed in accordance with the COBOL standard as specified by the American 
National Standards Institute (ANSI). The COBOL compiler can function with any system that runs under 
the control of the MCP. 


The COBOL compiler in conjunction with the MCP allows for various types of actions during compilation 
which are explained in the following paragraphs. 


Compilation Card Deck 


Control of the COBOL source language input is derived from presenting the compilation card deck to the 


MCP. See figure 4-2. 
? END 
SOURCE DATA | 
SOURCE DATA 
ARD 
? DATA CARDS 
TS : 


FILE STATE- 
MEN 


(OPTL) TON | 
? COMPILE CARD 


$ DOLLAR 
OPTION 
CARD(S) 


Figure 4-2. COBOL Compilation Deck 


Dollar Option Card 
The third card, excluding file statement cards, is the COBOL $ Option card. This card is used to notify 
the compiler which options are desired during a compilation. Without the $ Option Card, $ CARD LIST 
CHECK SINGLE CONTROL will be assumed. 
The $ Option card has the following characteristics: 

a. A$ sign must appear in column 7. 

b. There must be at least one space separating options on a card. 

c. There may be more than one option per card. 


d. The options may be in any order. 


e. Any number of $ cards may be used and may appear anywhere in the source deck. The option 
will be set or reset from that point on. 
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f. Columns | - 6 are used for sequence numbers 


The format of the $ Option card is as follows: 


$ [NO] option-1-++ [NO] option-n 


OPTIONS. 


The options available for the COBOL compiler are listed below: 


CARD 


LIST 


LISTP 


SINGLE 
‘ DOUBLE 
CODE 


- MERGE 


NEW 


CHECK 


SUPPRESS 


SPEC 


Input is from the source language cards or paper tape. This option is for documentation 
only. 


Creates a single-spaced output listing of the source language input, with error and/or 
warning messages, where required. 


Lists the source images during the first compilation pass, and prints the error messages 
as they occur. 


Causes the output listing to be printed in a single-spaced format. 
Causes the output listing to be printed in a double-spaced format. 
List object code following each line of source code from the point of insertion. 


Primary input is from a source other than a card reader and may be merged with a 
patch deck in the card reader. It is assumed to be from a disk file, with a file-ID of 
COBOLW/SOURCE, by default. 


If it is desired to change the input file-ID or change the input device from disk to tape, a 
LABEL EQUATION CARD must be used. The NEW option may be used with the 
MERGE option to create a new output source file plus changes. 


Creates a NEW output source file with changes, if any, entered through the use of the 
MERGE option, but does not include compiler option cards which must be merged in 
from the card reader when compiling from disk or tape. 


The output file will be created on disk by default with the file-ID of COBOLW/SOURCE, 


If it is desired to change the output file-ID or change the output device from disk to tape, 
a LABEL EQUATION CARD must be used. 


This option will cause the compiler to check for sequence errors and print a warning 
message for each sequence error. The CHECK option is set on by default at the beginning 
of each compile, but may be terminated with the NO CHECK option. 


Suppresses all warning messages except sequence error messages. The sequence 
error message can be suppressed with the NO CHECK option. 


If syntax ERRORS occur, this option negates the control and LIST option and causes 


only the syntax errors and associated source code to be printed. Otherwise the CONTROL 
and LIST options remain in effect. 
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“Non-numeric literal” 
Is inserted in columns 73-80 of all following card images when creating a new source 
file and/or listing. This option can be turned off or changed by a subsequent control 
card with the area between the quote marks containing blank characters. 


SEQ Starts resequencing, the output listing and the new source file if applicable, from the 
last sequence number read in and increments the sequence number by ten or by last 
increment presented in a previous $-option card. When resequencing starts at the 
beginning of the program source statements the sequence will start with 000010. 


SEQ nnnnnn 
Starts reweauencing the output listing and new source file if applicable from the 
sequence number specified by nnnnnn and increments the sequence numbers by ten. 


SEQ +nnnnnn 
Starts resequencing the output listing and new source file if applicable from the 
last sequence number read in and increments by the number specified by +nnnnnn. 
When resequencing starts at the beginning of the program source statements, the 
sequence will start with 000010. 


SEQ nnnnnn +nnnnnn 
Starts resequencing the output listing and new source file if applicable from the 
sequence number specified by nnnnnn and increments by the value of tnnnnnn. 


NO SEQ Terminates the SEQ option and resumes using the sequence number in the source state- 
ment as it is read in. 


CONTROL Prints the $-option control cards on the output listing. The LIST option must be on. 


NO When the NO option precedes one of the options, with the exception of MERGE 
which cannot be terminated, it will terminate the function of that option. 

REF 
During debugging additional monitoring can be done to see the effect upon variables 
specified in the MONITOR declaration and referenced in a statement that does not 
change its value. 

ANSI When used, will inhibit the EXTENSION of AT END ... ELSE, and during compilation 


will flag them as syntax errors. 


STACK [integer] 
Is used to increase the program stack by “integer” bits. The default size, when at 
least one PERFORM statement is used, is 1000 bits. 


NOCOP When used will generate COP entries in the code instead of a COP table causing more 
memory to be utilized but faster program execution. 


The NEW option does not have to be included when operating with a tape or disk source input, thus allow- 
ing temporary source language alterations without creating a new source output file. 


The MERGE option without the NEW option allows a disk or tape input file to be referenced and to have 
external source images included from the card reader on the output listing and in the object program. A 
new output file will not be created. 


Columns | - 6 of the Compiler Option Control card may be left blank when compiling from cards. A 
sequence number is required when compiling from tape or disk when the insertion of the $ option is 
requested within the source input. 


Source Data Cards 


The Source Data cards follow the $ Option control cards. These cards have two functions: (1) to update 
and create a newer version of a program, and (2) cause temporary changes to the tape or disk source 


program. 


The following two paragraphs outline the Source Data Cards that are available to use with the COBOL 


Compiler: 


a. 


VOID Patch Card. Punch the beginning’ sequence number in card columns 1-6 followed by a 
$ sign in column 7 with the word VOID starting in column 8, and terminate with the optional 
ending sequence number. This will delete the source statements beginning with the 6-<digit 
sequence number through the ending 6-digit sequence number. For example: 


nnnnnn $VOID [nnnnnn] 


If the ending sequence number is omitted, only the source statement associated with the beginning © 
sequence number will be deleted. For example: 


nnnnnn $VOID 


CHANGE or Addition Patch Card. Punch the 6-digit sequence number in card columns 1-6 of the 
card that is to be changed or added, followed by the data to be input in their applicable columns. 
These cards must be arranged in the sequential order of the source program in order to be 
MERGED correctly into the program. 


The COBOL Compiler has the capability of merging inputs from punched cards or paper tape, either of 
which may be merged with magnetic tape or disk. 


The output listing will indicate any inserts and/or replacements when in the MERGE mode. 


The following are examples of a COBOL compile deck. 


Example 1: 


2? COMPILE ALPHA WITH COBOL FOR SYNTAX 
2? DATA CARDS 
$ CARD LIST DOUBLE 
. source program deck . 


2? END 


Example 2: 


? COMPILE ALPHA WITH COBOL SAVE 
? DATA CARDS 
$ CARD NO CHECK DOUBLE 
source program deck. . 


2? END 
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Internal File Names 


The COBOL compiler’s internal file-identifiers and external file-identifiers for use in Label Equation are 


as follows: 


Internal File-name 


CARDS CARDS 

SOURCE COBOLW/SOURCE 
NEWSOURCE COBOLW/SOURCE 
LINE LINE 


Description 


Input file from the card reader. If $ MERGE is 
used, this file will be merged with the input file 
on disk or tape. The default input is from the card 
reader. 


Input file from disk or tape when the MERGE option 
is used. The default input is from disk. 


Output file to disk or tape for a NEW source file when 
the NEW option is used. The default output is to disk. 


Source output listing to the line printer. 


COBOL Internal File Names 
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FORTRAN COMPILER 


General 


FORTRAN (FORmula TRANslation) was designed for writing programs concerned with scientific and 
engineering applications in mathematical-type statements. The FORTRAN compiler translates these state- 
ments into object code which can be executed by the B 1700. 


B 1700 FORTRAN is designed to be compatible with FORTRAN IV, Level H, and to contain ANSI 
Standard FORTRAN as a subset. 


Compilation Card Deck 


Control of the FORTRAN source program is derived by presenting to the MCP the FORTRAN compilation 


card deck. See figure 4-3. 
? END 
/ SOURCE DATA | | 
SOURCE DATA | 
? DATA CARD | N\ 
ILESTATEMENT 
$ DOLLAR 
OPTION 


(OPTL) 
CARD(S) 


? COMPILE 


Figure 4-3. FORTRAN Compilation Deck 


Dollar Option Card 


The third card, excluding Label equation cards, and the standard COMPILE and DATA cards, is the 
FORTRAN compiler § Option control card. This card is used to notify the compiler as to which options 
are required during the compilation. By omitting the $ Option card, the options “CARD LIST SINGLE” 


are assumed. 


The format for the FORTRAN § Option control card is: 


$ [NO] option-1 --- [NO] option-n 
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The FORTRAN § Option control card has the following characteristics: 


a. A$ sign may appear in column 1 or 2. When placed in column 2, the $ option card will be 
included in the new output source file if such a file is generated. 


b. There must be at least one space between each item. 


c. Options may be in any order. 


d. Columns 73-80 are reserved for sequence numbering. 


e. Any number of option cards may appear within the source deck. 


OPTIONS 


The options that are available for the FORTRAN compiler are as follows: 


BIND 


CARD 


CODE 


DOUBLE 
DYNAMIC [integer] 


ERRORTRACE 


LIST 


MERGE 


NEW 


Causes the intermediate code files to be bound into an executable code file. 
This is a default option; if BINDING is not desired then NO BIND should be 
used. 


Input is from source language cards. This is a default option. 


Lists the object code for each source code line from the point of its insertion 
into the source deck. 


Causes output source listing to be double spaced. 


This specifies the size in words to be assigned for an object program’s dynamic 
memory. The compiler by default will assign the dynamic memory either of 
two ways: (1) if the data pages are less than 10, it assigns a size equal to the 
sum of the data pages, or (2) if the data pages exceed 10, then the size of the 
10 largest data pages are used. 


Provides a FORTRAN level trace of subprogram and statement usage prior to 

the detection of a run-time error. The ERRORTRACE option must be placed 
before the first executable statement of the main program or any subprogram. 
Once set it may reset at any point by the NO ERRORTRACE option. 


Creates a single spaced output listing of the source statements with error and/or 
warning messages. This is a default option. 


The MERGE option allows source input from disk or tape (disk by default, 
file-identifier SOURCE) to be merged with source statements from a card 
reader. The NEW option must be used with the MERGE option to create a new 
output source file. When the NEW option is not used, both the output listing 
and the object code file will reflect the merged statements but a new output 
source file will not be created. 


Creates a new source output file having a file-identifier of NEWSOURCE. The 
new output file will include any changes made by the use of the MERGE 
option and any compiler option statements that have the dollar sign in 
column two. 
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NO When used in conjunction with the following options, it will negate or put them 
in a reset condition. There must be a space between NO and the option. 


BIND 

CODE 
DOUBLE 

LIST 

SEQERR 
SAVEICM 
ERRORTRACE 
PROFILES 
TRACEF 


PAGE Causes the output listing to eject at that point and start a new page. 


PROFILES Is an optimization aid that indicates to the user those areas of a program that 
can be optimized to improve program performance; At run time the following 
data will be output by using the PROFILES option: 


a. Frequency of subprogram usage. 

b. Time spent in each subprogram. 

c. Use of individual statements within a subprogram. 
d. Use of each statement during program execution. 


The PROFILES option must be placed before the first executable statement of 
the main or subprogram. To reset the option use the $ NO PROFILES at any 
point within the program. 


SAVEICM Causes the intermediate code files for each syntax-error-free program part to 
be made a permanent disk file at the end of the compilation. 


SEQ Causes resequencing of the output listing and the new source file, if applicable, 
starting with the default number 00001000 and incrementing sequence num- 
bers by 1000. 


SEQ nnnnonnn = [nnnnnnnn] 


Causes resequencing of the output listing and the new source file if applicable. 
SEQ is followed by either an eight digit number which is the starting sequence 
number, or two eight digit numbers with the first number being the starting 
sequence number and the second the resequencing increment value. The 
default resequence increment is 1000. 


SEQERR Causes a warning message to be printed for statements out of sequence. 


SINGLE Causes the output listing to be printed in single spaced format. This is a 
default option. 


STACKSIZE _ [integer] 


Specifies the size in words to be allocated for the object program Evaluation 
stack. Default size is 100; maximum size is 4096. 


TRACEF Causes a FORTRAN level trace to be printed for each FORTRAN statement 
executed in the program. This option may be inserted anywhere within the 
program. Once set, it remains set until reset by using NO TRACEF. 
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VOID Causes the source input image corresponding to the sequence number of the 
VOID card to be deleted from the input disk file. 


VO IDnnnnnnnn Causes a series of source images to be deleted starting from the sequence num- 
ber in the sequence number field (73-80) through and including the sequence 
number of the VOID option. 

Internal File Names 
The FORTRAN Compiler’s internal file-identifiers and external file-identifiers for use in Label Equation 


are as follows: 


Internal File-name External File-ID 


(file-number) (Label) Description 
CARDS CARDS Input file from the card reader. 
LINE LINE Source output listing to the line printer. 
SOURCE NEWSOURCE When $ NEW is used the output file will go to disk or tape. 
The default output is to disk (80 character records, 
blocked 2). 
SOURCE SOURCE ' Input file is from disk or tape when $ MERGE is used. 


The default input is from disk and assumed to be 80 char- 
acter records, blocked 2. 


FORTRAN Internal File Names 
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BASIC COMPILER 


General 


BASIC is a problem-oriented language designed for a wide range of applications and may be easily applied to | 


business, commercial, engineering and scientific processing tasks. The BASIC language is designed for 
use by individuals who have little previous knowledge of computers, as well as individuals with considerable 
programming experience. A distinct advantage of BASIC is that its rules of form and grammar are quite 


easily learned. 


B 1700 BASIC includes the capabilities of the original Dartmouth College BASIC plus extensions provided 
for compatibility with the General Electric MARK IT® BASIC language. 

The BASIC compiler, in conjunction with the Master Control Program, enables source programs to be 
compiled through the use of a card reader or a card device. Compilation of the BASIC source language 
input is achieved by presenting the compilation card deck to the MCP. Control cards included in the 
compilation deck are of two general types: (1) MCP control cards, and (2) compiler $ Option control 
cards. The structure of the BASIC compilation deck is discussed in the text that follows: 


Compilation Card Deck 


The entities comprising the structure of the BASIC compilation deck and the order of their occurrence 


are shown in figure 4-4 below. 
$ DOLLAR | 
OPTION 


CARD(S) 


DAT. 


ACARD 
FILE STATEMENT 
(OPTL) 
COMPILE CARD 


Figure 4-4. BASIC Compilation Deck 
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Dollar Option Card 

The third card, excluding the optional Label Equation cards and the standard COMPILE and DATA cards, 
is the BASIC $ Option card. This card is used to notify the compiler which options are desired during a 
compilation. By omitting the $ Option card, the options “CARD LIST SINGLE” are assumed. 

The $ Option cards for the BASIC compiler have the following characteristics: 


a. All option cards are in a free-form format. 


b. A line-number,which is required to be sequential within the program, cannot be greater than five 
digits and must precede the § sign. 


c. The $ sign may appear anytime after the line-number arn before the first option. 

d. All options listed on the card may appear in any order. 

e. There must be at least one space between each option. 

f. $ cards may be used anywhere within the source deck to either set or reset an option. 
The format of the $ Option card is: 


line-number $ [NO] option-1 --- [NO] option-n 
OPTIONS 
The following options are available for the BASIC compiler. 


CARD Symbolic input is from source language cards. At the present time, this option is for 
documentation purposes only. 


LIST Creates a compilation output listing of the source language input, with error and/or 
warning messages, where required. LIST is a default option. 


SINGLE Causes the compilation output listing to be printed in a single-spaced format. SINGLE 
is a default option. 


DOUBLE ~ Causes the compilation output listing to be printed in a double-spaced format. 


CODE Lists the object code generated for a source statement from the point of insertion into 
the source deck. 


NO Each of the above options may be preceded with NO. This enables the options to be 
set for selected program parts and then reset as desired. When an option is preceded 
by NO, there must be at least one space between the word NO and the option to be 
terminated. 

Source Input Cards 


The source program cards have the following characteristics: 


a. Each card is taken as a different line and can contain only one statement. If the 96-column 
cards are used, the source statement must be contained in the first 80 columns. 
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b. There can be no continuation cards. 

c. Each card between the ? DATA card and the ? END card must contain a line-number. 
d. <A line-number starts in column | and can be a length of 5 digits. 

e. The first non-numeric character will terminate the line-number when less than 5 digits. 
f. The line-number is used both as a statement label and sequence number. 

g. Each statement is sequence checked by the BASIC compiler as it is read in. 


h. Spaces or blanks have no significance within a source statement except for information con- 
tained in string constants. Spaces can be used to make a program more readable. 


Intrinsic Files 
The BASIC intrinsic files (identified by the name BAS.INTRIN/ nnnnnnnn) must be present on disk when 
a compiled BASIC program is executed; however, they are not needed when compiling the BASIC pro- 
gram. The intrinsic files contain input/output routines and intrinsic functions provided by the BASIC 
language. If the intrinsic files reside on a user pack the INTRINSIC.DIRECTORY control instruction must 
be used to identify the user pack, otherwise, the intrinsics are assumed to reside on the system pack. 
Example: 

? EXECUTE program-name 

? INTRINSIC.DIRECTORY dp-identifier 

? END 
Sample Compilation Deck 
In the following example, a BASIC program is to be compiled to LIBRARY and the object program, 
EXAMPLE/PROGRA\M, is to be entered in the disk directory of a removable disk cartridge labeled BAS. 
In addition, the BASIC compiler resides on the removable disk, BAS. A $ card is enclosed to cause the 
compilation output listing to be printed in a double-spaced format. The options CARD and LIST being 
default options are not required, but are included on the $ card for documentation purposes only. 

7 COMPILE BAS/EXAMPLE/PROGRAM BAS/BASIC/LIBRARY 

? DATA CARDS 

10 $ CARD LIST DOUBLE 

20 INPUT X, Y, Z 

30 PRINT “X=”; X, “Y=”; Y, “Z=";Z 

40 END 


? END 
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In the next example the compiled program EXAMPLE/PROGRAM is ready for execution. The compiled 
program as well as the BASIC intrinsic files and the BASIC interpreter reside on the removable disk pack 
labeled BAS. The card file labeled INPUT is required during execution of this program. 

? EXECUTE BAS/EXAMPLE/PROGRAM 

2?  INTRINSIC.DIRECTORY = BAS 

? INTERPRETER = BAS/BASIC/INTERP2 

2? END 

? DATA INPUT 

12,.32,56 
? END 


Internal File Names 


The BASIC Compiler’s internal file-identifiers and external file-identifiers for use in Label Equation are as 
follows: 


Internal File-name External File-ID Description 


CARDS CARDS Input file from the card reader. 


LINE LINES Source output listing to the line printer. 


BASIC Internal File Names 
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UPL COMPILER 


General 


The User Programming Language (UPL) is a problem oriented language developed for writing B 1700 system 
software. The UPL Compiler is a single pass compilation that transforms the programmer’s source state- 
ments into object code. Figure 4-5 illustrates the generation of an UPL object program. 


UPL 
OBJECT 
CARD 


UPL 
COMPILER 


UPL SOURCE 
COMPILATION 
CARD DECK 


UPL 
PROGRAM 
SOURCE 
LISTING 


Figure 4-5. UPL Compilation Process 


Compilation Card Deck 


Figure 4-6 contains an example of a UPL Compilation deck. 


[oe 
UPL | 
SOURCE 


STATEMENTS 


FILE 
STATEMENTS 
(OPTIONAL) 


? DATA CARDS 


$ DOLLAR i 
OPTION 


CARDS 


? COMPILE 


Figure 4-6. UPL Compilation Card Deck 
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Compiler Options 


The UPL Compiler has certain options available through a Dollar card ($) that gives the operator the ability 
to override some of the standard compiler functions, alter stack sizes, suppress error and/or warning mes- 
sages, and merge and create a new source file from an existing file. Dollar options are either in a set or 
reset condition. The UPL Compiler is preset with the following options: AMPERSAND, CHECK, LIST, 
and SINGLE. 


The UPL Compiler option card has the following format: 


| $ [NO] option-1 +--+ [NO] option-n 


The UPL Compiler Dollar option card has the following characteristics: 


a. Column one must contain a $ sign. 

b. There must be at least one space between options on the same card. 

c. Options may be set or reset in any order. 

d. Columns 73-80 are reserved for sequential numbering. 

e. There is no limit as to the number of options being set or reset during the compilation. 
f. |The option NO when appearing before any other option resets or negates that option. 


The UPL Compiler options and their description are as follows: 


AMPERSAND Prints those ampersand cards that are examined. 

CHECK Checks the source input file for sequence errors. 

CODE Print the SDL object code generated for each source statement. 
CONTROL Prints all compiler option cards from that point. If the option control 


word CONTROL is required to be printed, the $ CONTROL (space) 
CONTROL format must be used. 


CREATE.MASTER This option must be the first card in the compilation deck and causes the 
compiler to perform the following functions: 


a. Dump information to the master information files. 
b. Create a new source file. 


c. Create a new code file. 


CSSIZE integer Assigns the number of entries in the Control stack represented by 
integer and overrides the compiler estimate. 

DEBUG Compiler debug only. 

DETAIL Causes the compiler to list the expansion of all define invocations. 

DOUBLE Double space listing. 
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DYNAMICSIZE integer 


ESSIZE integer 


FORMAL.CHECK 


INTERPRETER 
file-identifier 
INTRINSIC 
file-identifier 
(family-name only) 


LIST 


LISTALL 


MERGE 


NEW 


NO 


NSSIZE integer 


PAGE 

PPSIZE integer 
SEQ beginning- 
sequence-number 
increment 


SINGLE 


SIZE 


SUPPRESS 


Assigns the value of the integer as the estimated memory size allocated 
for paged arrays. Integer is expressed in bits. 


Assigns the number of entries in the EVALUATION stack by integer and 
overrides the compiler estimate. 


The checking of the actual parameters passed to each procedure during 
execution against the TYPE and LENGTH specifications of their corre- 
sponding formal declarations. Also, the values returned from function 
procedures will be checked against the TYPE and LENGTH in the pro- 
cedure head statement. Lack of correspondence is a run time error. 


Causes the program when executed to use the assigned Interpreter rather 
than the compiler default interpreter. 


Causes the program when executed to use those intrinsics with the 
assigned family-name rather than the compiler assigned family-name. 
Prints the source input that was compiled. The NO option when invoked 


with LIST will reset the LISTALL option also. 


Prints all source input regardless if conditionally excluded. The LISTALL 
option sets the LIST option, but NO LISTALL does not reset LIST. 


Indicates to the compiler that the source file is on tape or disk and 
there are cards to be merged during the current compilation. 


Creates a new primary source file. 
The presence of the NO option immediately before any other option 
causes that option to be reset from that point on during the 


compilation. 


Assigns the number of entries expressed by integer to the Name 
stack thereby overriding the compiler’s estimated size. 


Ejects page. 


Assigns the number of entries expressed by integer to the Program 
Pointer stack thereby overriding the compiler’s estimated size. 


Causes the output file to be resequenced beginning with the number 
used with SEQ. 
Single space listing. 


Outputs at the end of the listing, the code segment names and 
their sizes. 


Causes all warning messages .to be suppressed. To suppress sequence 
error messages invoke the NO CHECK option. 
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VOID sequence Causes all records in the primary source file (as in the case of the 

number MERGE) to be removed from the sequence number of the VOID 
card itself through the sequence number entered with the VOID 
option. 


The VOID option has the following restrictions: 
a. Must be the only compiler option on the card. 
b. Cannot be preceded by the NO option. 
c. Must contain a sequence number in columns 73-80. 


VSSIZE integer Assigns. the number of entries expressed by integer to the size of the 
VALUE stack thereby overriding the compiler estimated size. 


XMAP Causes an extended SDL object code MAP file to be created showing 
the relative displacement of object code per source card sequence 
number, per Code Segment. 


XREF The XREF options may be used in one of the two following modes: 
XREF.ONLY 
a. AS$XREF card at the beginning of the source deck will 
cause the compiler to build and XREF file, then ZIP 
SDL/XREF to sort and print the file at the end of the 
pre-pass. The compilation will continue. 


b. AS$XREF.ONLY card at the beginning of the source deck will 
cause the compilation to be terminated at the end of the pre- 
pass after the SDL/XREF program has been ZIPPED. 


Internal File Names ’ 


The UPL Compilers internal and external file identifiers are as follows: 


Internal External Description 
CARDS CARDS Card source input file. 
SOURCE SOURCE Primary source input file if MERGE option 
used, 
NEWSOURCE NEWSOURCE Updated source output file if NEW option used. 
LINE LINE Line printer file. 
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NDL COMPILER 


General 


The Network Definition Language (NDL) is a high level language for data communication and provides 
a means of generating a B 1700 Network Controller. The B 1700 NDL Compiler translates the input 
source code and outputs a NDL program listing, a Network Controller code file, and the Network 
Information File (NIF). Figure 4-7 below illustrates the NDL generation process. 


A sft 8) 


NDL 
COMPILER 


NDL 
SOURCE 

COMPILATION 
DECK 


C000 
= SOO 


ee 
(TOO 


NDL 
LISTING 


NETWORK 


NETWORK 

INFORMATION CONTROLLER 

FILE OBJECT 
CODE 


Figure 4-7. NDL Generation Process 


Compilation Card Deck 


Figure 4-8 contains an example of a NDL compilation card deck used to compile a NDL program. 


NDL 
SOURCE DATA 
CARDS 


? DATA CARDS 


FILE 
STATEMENTS 
(OPTIONAL) 


$ DOLLAR 
OPTION 
CARDS 


? COMPILE 


Figure 4-8. NDL Compilation Card Deck 
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Compiler Options 


There are various options available that when invoked affect the compilation process. The options cover 
areas such as list format, error and warning message handling, maintenance, changing stack sizes, and 
merging source code. 


An option is either in a set or reset condition. The NDL compiler is preset with the following options: 
LIST, CHECK, and DOUBLE. All other options must be invoked using the dollar option card at compile 
time. The NDL dollar option card has the following format: 

$ [NO] option-1 ... [NO] option-n | 


The dollar symbol ($) must be in column one with one or more spaces separating each option specified. 
With the one exception LIBRARY, there may be multiple options per card. 


The available options and an explanation of their functions appear alphabetically as follows: 
Option Description 


CHECK This option causes the compiler to print warning messages 
for sequence errors in the source language input. A 
sequence error will occur when the sequence number of 
the last card is greater than or equal to the current 
sequence number. 


CODE The generated SDL code (S-operators) will be listed on 
the line-printer. 

CONTROL The dollar ($) option cards will be output on the object 
program listing. 

CSSIZE integer This option is used to alter the Control stack size to 
integer entries. 

DOUBLE Double space listing. 

DYNAMICSIZE integer Sets the Network Controller’s dynamic memory size to 


integer bits. 


ESSIZE integer The Network Controller’s Evaluation stack size may 
be set to integer entries. 


FORGETERRORS Directs the compiler to generate the object Network 
Controller despite syntax errors. 


LIBRARY The NDL source code specified by standard identifier 
is retrieved from the NDL source/standards and inserted 
in the user’s program following the $ LIBRARY card. 


The LIBRARY option may not be included on a card 
containing other options. 


When the LIBRARY option is used to access standard 

REQUEST and CONTROL routines, the standard 

REQUESTS must precede the standard CONTROLS. 
LIST The source code will be listed. 
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LST The source code will be listed. 


MERGE This option is used to merge the primary input with the 
secondary input. 


NEW A new source file will be created for use later as secondary 
input when this option is specified. 


NIF This option allows the creation of a new Network 
Controller in about half the time required for a total 
compilation. The old requests and line control code 
must remain unchanged. 


NSSIZE integer The Network Controller’s Name stack size may be set 
to integer entries. 


NO Options may be reset by specifying $ NO followed by the 
name of the option to be reset. This allows options to be 
set and reset at the user’s discretion. NO does not affect 
the VOID or LIBRARY options. 


PPSSIZE integer Sets the Network Controller Program Pointer 
stack size to integer entries. 


SEQ The source may be sequenced by supplying a beginning 
sequence number and an increment. The numbering will 
begin at SEQ BASE and will be incremented by SEQ 
INCRMT. A plus sign (+) is used to separate SEQ BASE 
and SEQ INCRMT which are both integers. 


| $ SEQ SEQBASE + SEQ INCRMT | 


If only $ SEQ is specified thereby omitting SEQ BASE 
and SEQ INCRMT, the numbering will start with 
00000000 and increment by 100. 


SGL Single space listing. 
SINGLE Single space listing. 
SUPPRESS Prohibits the syntax warnings to be printed on the object 


program listing. 


VSSIZE integer The Network Controller Value stack size may be set to 
integer bits. 


VOID When VOID is used in conjunction with $ MERGE, it elimi- 
nates certain unwanted secondary source records from the new 
new source file being created. 


By specifying $ VOID, the secondary source record with the 
current sequence number is skipped by the compiler. 


$ VOID may also be followed by an eight character integer 
which instructs the compiler to skip all secondary source 
records beginning at the current sequence number and con- 
tinuing until a secondary source record is read that has a 
sequence number higher than the eight character integer 
specified. 
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Internal File Names 


The NDL’s internal and external file identifiers are as follows: 


Internal 


CARDS 
LINE 


SOURCE 


NEWSOURCE 


NIF 
ADDRESS 
MACRO 


LIBRARY 


External 


CARDS 
LINE 
SOURCE 


NEWSOURCE 


NDL/NIF 
NDL/ADDRESS 
NDL/MACRO 


NDL/LIBRARY 
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Description 


Input file from card reader. 
Source output listing to line printer. 


Input file from disk or tape when the 
MERGE option is invoked. 


Output file to disk or tape when the new 
option is invoked. Default is to disk. 


Network Information File 
Network Controller Address File 
Skeletal Network Controllers 


Library 


MIL COMPILER 


General 


The Micro Implementation Language (MIL) is a symbolic coding technique that makes available all the 
capabilities of the B 1700 processor. A MIL program contains a set of micro instructions that are 
directly executable upon the B 1700 hardware. MIL assumes interpretive or indirect processing of 
information contained in main memory. 


Compilation Card Deck 


Figure 4-9 contains an example of a MIL compilation deck. 


so 
CA 
? DATA CARDS 
FILE 
STATEMENTS 
(OPTIONAL) 


$ DOLLAR $ DOLLAR 
OPTION MODULE 


? COMPILE 


CARDS OPTION CARD 


Figure 4-9. MIL Compilation Card Deck 


Compiler Options 


The $ Option Card is used to notify the MIL Compiler as to which options are required by the programmer 
during compilation. 


The $ Option card for the MIL Compiler has the following format: 


5 [NO] option-1 ... [NO] option-n 


The MIL $ Option Card has the following characteristics: 


a. Column one must be a § sign. 
b. There must be at least one space between options. 


c. Options may be in any order. 
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d. Columns 73-80 are reserved for sequence numbering. 


e. Any number of $ Option Cards may appear anywhere within the source deck. 


f. The optional word NO appearing before any option RESETS that option. 


ALLCODE 
AMPERSAND 
CHECK 
DEBUG 
DECK 
DOLLAR 
DOUBLE 
EXPAND 
FORCE 


HEADINGS 


LINES.PER.PAGE 
LIST 


LISTALL 


MERGE 


NEW 

NO 

PAGE 
PAGE.NUMBERS 


PARAMETER.BLOCK 


SEQ 
SINGLE 


SUBSET 


The MIL Compiler is preset with the following options: LIST, ALLCODE, SINGLE, AMPERSAND, 
and CHECK. 


Lists all codes generated by each MIL statement. 
Prints all ampersand (&) cards. 

Checks for sequence errors. 

Debugs compiler only. 

Punches an object deck. 

Prints all dollar ($) cards. 

Double spaces listing. 

Prints all statements within a macro invocation. 
Outputs all files regardless of syntax errors. 


Prints headings and titles on top of each page; does not 
affect line count. 


Specifies the number of lines to be put on the page of a listing. 
Lists all MIL source input that is compiled. 


Lists all MIL source input regardless whether conditionally 
excluded. 


Merges the secondary source of input with the file SOURCE. When 
a duplicate sequence number exists the record from the card file will 
be used. 

Creates a new source file. 

Resets option. 

Ejects page of listing at that point. 

Numbers the pages of the listing and maintains a count. 

Used in conjunction with DECK and causes a parameter block to be 
punched with the deck. Used primarily with interpreters that are 
to be run with the MCP. 

Resequences and outputs NEWSOURCE file and listing. 


Single spaces program listing. 


Generates code for the B 1710 series processors. 


“4 
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SUPPRESS Suppresses all warning messages except sequence error messages. 


VOID Voids those images from the secondary input file SOURCE which 
have sequence fields less than or equal to the terminating 
sequence field. If the terminating sequence field is missing, then the 
only image voided is the first one with the same sequence field as 
the VOID card. 


XREF Produces a listing of all user specified names and labels with each 
identifier associated with its sequence number for each declaration 
and invocation. 

XREF.LABELS Produces a cross reference of labels only. 

XREF.NAMES Produces a cross reference of user specified names only. 
Module Option Dollar Card 
The module option dollar card ($) is used to set or reset user defined toggles used in conjunction with 
IF statements in the conditional inclusion of source statements. It may be used anywhere within the 
source deck, and each module option dollar card affects only those user defined toggles which are 
referenced on that card. A user defined toggle can only be referenced by an IF statement when declared 
(set or reset) on a module option dollar card. 
Example: 

$ SET SYSTEM1, RESET SW2, SET SW4, SET SW5 


Internal File Names 


The MIL Compiler’s internal and external file identifiers are as follows: 


CARDS CARDS Input file from the card reader. 
LINE LINE Source output listing to the printer. 


SOURCE SOURCE Input file from disk or tape when the MERGE 
option is invoked. 


NEWSOURCE NEWSOURCE Output file to disk or tape when the NEW 
option is invoked. Default is to disk. 
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Object Code Deck Format 


The DECK option causes the object code to be output to punched cards. The cards have the following 
format with all fields except the program identifier in hexadecimal format. 


Card Columns Description 
1-6 24-bit control memory address. 
8-9 8-bit count of the number of bits of data on this card. 
11-70 Contains up to 240 bits of data, left justified. 
72-80 Program identifier, used for documentation only. 


Compiler Restrictions 


a. The only source of input is the card reader, unless otherwise specified by the MERGE option. 
Once the MERGE option has been invoked, card only input is not possible. 


b. When dollar cards ($) are not included in the compilation deck, the default options will prevail. 


c. Options may be reset only by using the NO option. A space must separate NO and the 
option being reset. 


d. Comments may appear on dollar cards only if preceded by either an asterisk (*) or a percent (%) 
sign. 


e. Dollars cards are not included as part of the NEWSOURCE file when the option NEW is specified. 
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SDL COMPILER 

General 

The Software Development Language (SDL) was developed specifically for writing the system software 
for B 1700 systems. SDL is a high-level, procedure oriented language. All programs written in SDL 


source language must be processed by the SDL Compiler. The SDL Compiler transforms the source 
statements into S-Code to be interpreted by a set of micro-instructions called firmware. 


Compilation Card Deck 


Figure 4-10 contains an example of a SDL compilation card deck. 


(re 
SOURCE l 
DECK 


$ DOLLAR | 
OPTION 


CARDS 


FILE 
STATEMENTS 
(OPTIONAL) 


? DATA CARDS 


? COMPILE 


Figure 4-10. SDL Compilation Card Deck 


Compiler Options 


The SDL Compiler has certain options that are available to the operator or programmer that may be 
implemented at the time of compilation. These options are input by card along with the source deck 
and have the following format: 


$ [NO] option-1...[NO] option-n 


The SDL Dollar ($) Options have the following characteristics: 
a. Column one must contain a $ sign. 
b. There must be at least one space between options. 
c. Options may be in any order. 


d. Columns 73-80 are reserved for sequence numbering. 


4-31 


e. Any number of options may appear anywhere within the source deck. 


f. |The option NO appearing before any other option resets or negates that option. 


AMPERSAND 
CHECK 


CODE 


CONTROL 


CREATE.MASTER 


CSSIZE integer 


DEBUG 


DETAIL 


DOUBLE 


DYNAMICSIZE integer 


ESSIZE integer 


FORMAL.CHECK 


INTERPRETER 
file-identifier 


INTRINSIC 
file-identifier 
(family-name only) 


The following is a list of the SDL Compiler options and their definitions. 


Prints those ampersand cards that are examined. 
Checks the source input file for sequence errors. 


Prints the SDL object code generated for each source 
statement. 


Prints all Compiler Dollar Option cards from that point. 
If the option word CONTROL is to be printed, $ CONTROL 
(space) CONTROL format must be used. 


When used, this option must be the first card in the compilation 


deck and causes the compiler to perform the following 
functions: 


a. Dump information to the master information files. 
b. Create a new source file. 
c. Create a new code file. 


Assigns the number of entries in the Control stack 
represented by integer and overrides the compiler estimate. 


Debugs compiler only. 


Causes the compiler to list the expansion of all define 
invocations. 


Double spaces listing. 


Assigns the value of the integer as the estimated memory size 
allocated for paged arrays. Integer is expressed in bits. 


Assigns the number of entries in the Evaluation stack 
by integer and overrides the compiler estimate. 


Causes the checking of the actual parameters passed to each 
procedure during execution against the TYPE and LENGTH 
specifications of their corresponding formal declarations. 
Also, the values returned from function procedures will be 
checked against the type and length in the procedure head 
statement. Lack of correspondence is a run time error. 


Causes the program when executed to use the assigned 
interpreter rather than the compiler default interpreter. 


Causes the program when executed to use those Intrinsics 


with the assigned family-name rather than the compiler 
assigned family-name. 
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LIST 


LISTALL 


MERGE 


NEW 


NO 


NSSIZE integer 


PAGE 


PPSIZE integer 


SEQ beginning-sequence- 
number increment 


SINGLE 
SIZE 


SUPPRESS 


VOID sequence number 


VSSIZE integer 


XMAP 


Prints the source input that was compiled. The NO option 
when invoked with LIST will reset the LISTALL option also. 


Prints all source input regardless if conditionally excluded. 
The LISTALL option sets the LIST option on, but NO 
LISTALL does not reset LIST. 


Indicates to the compiler that the source file is on tape or 
disk and there are cards to be merged for the current 
compilation. 


Creates a new primary source file. 


The presence of NO immediately before any other option 
negates that option. 


Assigns the number of entries expressed by integer to the 
Name stack thereby overriding the compiler estimated size. 


Fjects page. 


Assigns the number of entries expressed by integer to the 
Program Pointer stack thereby overriding the compiler 
estimated size. 


Causes the output file to be resequenced beginning with the 
number used with SEQ. 


Single spaces listing. 


Outputs at the end of the listing the code segment names 
and their sizes. 


Causes all warning messages to be suppressed. To suppress 
sequence error message invoke the NO CHECK option. 


Causes all records in the primary source file (as in the case of 
the MERGE) to be removed from the sequence number of the 
the VOID card itself through the sequence number entered 
with the VOID option. 


The VOID option has the following restrictions: 


a. Must be the only compiler option on the card. 
b. Cannot be preceded by the NO option. 
c. Must contain a sequence number in columns 73-80. 


Assigns the number of entries expressed by integer to the size 
of the Value stack thereby overriding the compiler 
estimated size. 


Causes an extended SDL object code MAP file to be created 


showing the relative displacement of object code per source 
card sequence number, per Code Segment. 
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Internal File Names 


The SDL Compiler’s internal and external file identifiers are as follows: 


Internal External Description 


CARDS CARDS 


Card source input file. 

SOURCE SOURCE Primary input source file if MERGE option 
used. 

NEWSOURCE NEWSOURCE Updated source output file if NEW option 
used. 

LINE LINE Line printer file. 


ee am: 


SDL Recompilation 


The recompilation of an SDL program creates a Master Information File. 


The create master must take place once and then may be followed by successive recompilations. Both the 


create master and the recompilation may be performed at the same time. In addition it is possible to 
perform successive regular compilations without invoking the recompilation facility. 


CREATING MASTER INFORMATION FILES 


In order to create Master Information Files, the first card of the compilation source file must be a 
$ CREATE.MASTER option card. This option causes the SDL Compiler to perform the following 
functions: 

a. Save information needed for the recompilation into master files. 

b. Create a new source file about which the information is to be used. 

c. Use the Master Information Files and the new source file to create a new output code file. 
The following files contain the information to be saved and used in the recompilation process. 

NEWSOURCE 

NEW.INFO.FILE 

NEW.BLOCK.ADDRESS.FILE 

NEW.SECONDARY.FILE 


NEW.FPB.FILE 
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The following information is contained in the master information files: the input source images, Lexic 

Level one procedure boundaries for both the source file and object file, Lexic Level zero symbol tables, a 
record of all code addresses that have been emitted, the object code from which code addresses that have 
been emitted, the object code from which code addresses that have been emitted, the object code from which 
code addresses have been excised, the File Parameter Blocks, and SCRATCHPADS. (Refer to B 1700 Master | 
Control Reference Manual, dated June, 1974, and B 1700 System Reference Manual, dated December, 1973.) 


CREATE MASTER RESTRICTIONS 
The create master operation has the following restrictions: 
a. $CREATE.MASTER must be the first card of the compilation source card file. 
NOTE 


This is to include any ampersand cards; they sould be a 
sequenced. 


b. $ NEWis not needed for this operation. 
c. $ SEQ should be used if any input source images do not contain sequence numbers. 
RECOMPILING 


Recompilation is performed on a Lexic Level one procedural basis. That is, the outermost procedure 
containing a recompilation source card is the procedure which is recompiled. The code that is produced by 
the recompilation will be merged into, and in some cases replace some of the information created during 
the create master process. 


The recompilation is invoked by including as the first card of the recompilation source deck a 
$ RECOMPILE. 


The $ RECOMPILE causes the compiler to use the recompilation source deck (usually referred to as 
“patches”’) and the master information files to locate the Lexic Level one procedures and generate the same 
information for them as was generated for the entire program in the create master operation. This infor- 


mation is then combined, procedure by procedure, with the Master Information Files to produce the final 
form of the program that is turned into a new code file. 


RECOMPILATION RESTRICTIONS 
The recompilation process has the following restrictions: 
a. The $RECOMPILE must be the first card of the recompilation source deck (patch deck). 


b. The recompilation source deck may contain dollar cards, and ampersand (SET and RESET) 
cards, followed by the patch cards. 


c. Lexic Level zero code cannot be patched. This includes all global data, Lexic Level one procedure 
headings, and the main program. 


d. Neither $ SEQ or §$ MERGE options may be invoked while using § RECOMPILE process. 


e. The source file that is input during the recompilation must be on disk in order that it may be 
accessed randomly. 
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CREATE MASTER AND RECOMPILE OPERATION PERFORMED TOGETHER 


Both the create master and the recompilation process may be performed at the same time. Simply adhere 
to the rules for each separate operation and use $ RECOMPILE CREATE.MASTER as the first card of the 
source deck. It should be noted, however, that this procedure updates some of the information in the file 
MASTER.INFO.FILE. Therefore, the file must be saved because if any subsequent recompilations are 
desired, they must be performed against the saved master file. 


GENERAL INFORMATION 


1. The only information which may be listed during a recompilation is that which is being 
recompiled. 


2. Both the source file used with $ CREATE.MASTER and the file created by $ CREATE.MASTER 
may be on tape, but the new source file must be placed on disk prior to any recompilations. 


3. Because of the disk space required for recompilation, it is advantageous to keep source files on 
tape until needed. 


4. The source image file created by the create master process contains no information other than the 
source images. Therefore it may be used in a regular compilation. 


SDL COMPILATION DECK EXAMPLES 
Compile and Create Master 


COMPILE SA SDL LIBRARY 

FILE SOURCE NAME SA0206/SOURCE TAPE; 

FILE NEWSOURCE NAME SA0410/SOURCE TAPE; 

FILE NEW.INFO.FILE NAME SA0410/INFO; 

FILE NEW.BLOCK.ADDRESS.FILE NAME $A0410/BLOCK.ADDRESS; 
FILE NEW.SECONDARY.FILE NAME SA0410/SECONDARY; 
FILE NEW.FPB.FILE NAME SA0410/FPB; 

DATA CARDS 

CREATE.MASTER 

MERGE LIST SINGLE SIZE SEQ 

[PATCH CARDS] 

[99999999 CARD] 

? END 


OND NDI 


TA SF 


Recompile 


COMPILE SA SDL LIBRARY 

FILE SOURCE NAME SA0410/SOURCE; 

FILE MASTER.INFO:FILE NAME SA0410/{NFO; 

FILE MASTER.BLOCK.ADDRESS.FILE NAME SA0410/BLOCK.ADDRESS; 
FILE MASTER.SECONDARY.FILE NAME SA0410/SECONDARY; 
FILE MASTER.FPB.FILE NAME SA0410/FPB; 

DATA CARDS 

RECOMPILE 

LIST SINGLE SIZE 

VSSIZE 10000 NSSIZE 100 

[PATCH CARDS] 

[99999999 CARD] 

? END 


io SS OO) 
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Recompile and Create Master 


oe eS ee ee i i i i i 


COMPILE SA SDL LIBRARY 

FILE SOURCE NAME SA0410/SOURCE; 

FILE MASTER.INFO.FILE NAME SA0410/INFO; 

FILE MASTER.BLOCK.ADDRESS.FILE NAME SA0410/BLOCK.ADDRESS; 
FILE MASTER.SECONDARY.FILE NAME SA0410/SECONDARY; 
FILE MASTER.FPB.FILE NAME SA0410/FPB; 

FILE NEWSOURCE NAME SA0411/SOURCE TAPE; 

FILE NEW.INFO.FILE NAME SA 0411/INFO; 

FILE NEW.BLOCK.ADDRESS,.FILE NAME SA0411/BLOCK.ADDRESS; 
FILE NEW.SECONDARY.FILE NAME SA0411/SECONDARY; 

FILE NEW.FPB.FILE NAME SA0411/FPB; 

DATA CARDS 

RECOMPILE CREATE.MASTER 

VSSIZE 10000 NSSIZE 100 

LIST SINGLE SIZE 


[PATCH CARDS] 
[99999999 CARD] 


? 


END 
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REMOTE JOB ENTRY SYSTEM (RJE) 


Introduction 


The B 1700 Remote Job Entry system uses data communication techniques to allow a B 1700 user to enter 
a program at the B 1700 system for execution by a central computer. Either a B 1714 or B 1720 series 
Burroughs computer may be used as an input device, and will appear as a remote terminal to the central 
computer. The central computer may be any Burroughs B 2700/B 3700/B 4700/ or B 6700 system. 
Following execution of the program by the central system, all output information for the console printer, 
line printer, or card punch is transmitted to the remote B 1700 system. 


The Remote Job Entry System 


A typical RJE system is illustrated in figure 4-11. 


B 1700 RJE SYSTEM 


: DATA COMM 
INPUT/OUTPUT : HANDLER 


PROGRAM : PROGRAM CENTRAL 


COMPUTER 
SYSTEM 


CARD LINE CONSOLE ~ 
READER PRINTER PRINTER 


Figure 4-11. Remote Job Entry System 


All central computer systems can accommodate more than one remote system, with the maximum number 
permissible being dependent on the central system’s restrictions. 


The Remote Job Entry system software resides on the systems disk and consists of four programs: 
RJE/DCH, RJE/NDLDCH, RJE/IO, and RJE/MCS. 


The RJE/DCH and RJE/NDLDCH programs are data communications handlers that perform all transmitting 
and receiving of data between the central computer and the remote B 1700 system. Unless specifically 
named, the RJE/DCH and RJE/NDLDCH programs will be referred to as data communications handlers in 
this subsection. 
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The RJE/IO and RJE/MCS programs perform all input/output operations between the data communications 
handler and the card punch, card reader, line printer, and console printer. These two programs also direct 
all messages received from the central computer to the appropriate output device of the remote system. 
Unless specifically named, the RJE/IO and RJE/MCS programs will be referred to as input/output programs 
in this subsection. 


Operating Instructions 


€ 
The B 1700 Remote Job Entry system software is initiated by executing the input/output program. The 
input/output program then zip executes the data communications handler program, which displays the date 
and time of execution on the console printer. The data communications handler then requests the port, 
channel, and adapter numbers by displaying ““ACCEPT’”’ on the console printer. The operator must then 
supply the proper numbers with the AX message in the following format: 


-indexAXnnnnnn 


adapter number 

channel number 

port number 

mix-index of Data Comm handler 


Example: 
1AX070400 


When the Data Comm handler accepts this message, it establishes communication with the central system. 
When switched lines are used, the B 1700 operator must dial the central system manually. One of the two 
following messages are displayed on the console printer to indicate that communication has been established 


between the remote and central systems. 
ON LINE — Indicates that the remote system detected the central system first 


HOST ESTABLISHING — Indicates that the central system detected the remote system first 


Remote Deck Control Cards 
A special feature has been implemented in the MCP to distinguish those control cards for the remote 


(B 1700) system from the control cards for the central system since each require an invalid character to 
define a control card. This feature uses the control words STREAM and TERMINATE to allow programs 


to read control cards in RJE mode. 
? STREAM RJE/CARDS 
remote deck(s) 

? TERMINATE RJE/CARDS 


All card images in the remote deck(s) will be transmitted to the central system. If the last card in the 
remote deck(s) is not the TERMINATE card, the CARD READER NOT READY message is output and 


waits for more card input. 
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RJE System Control Messages 


Input messages for the remote jobs being processed by the central computer may be input by the B 1700 
console printer using the following format: 


mix-index AX (message) 
The mix-index of the AX message refers to the mix index number of the input/output program. The 
content of the message sent by the AX message is dependent on the central systems demands. In general, 
these messages include all central system input messages that allow the operator to check the status of, and 
exert control over, all programs and data files entered via the remote system. 


Remote Control Message Entry 


Local control messages or those being entered through the B 1700 and intended for B 1700 RJE system 
software are designated by the use of a period (.) immediately preceding the content of the message. 


Example: 
mix-index AX (.message) 


Blanks (spaces) are allowed anywhere within the text of the message, but the first character must be a 
period (.). 


There are ten local control messages. Any other messages entered using the period as the first character will 
result in the following message being displayed: 


ERROR: INVALID OPERATORIN . INSTRUCTION, RE-ENTER 
Local Control Messages 
Following are the ten valid local messages. 
.AUDIT or .IOLOG 
The .AUDIT or .LOLOG commands can be used to instruct the Data Comm handler to either stop or start 
auditing Data Comm input/output activity. The first entry of .AUDIT or .IOLOG initiates auditing. The 
next entry of .AUDIT or .LOLOG stops auditing. Each subsequent entry of .AUDIT or .IOLOG switches 
the auditing process to the opposite state. The mix-index used with .IOLOG refers to the mix-index number 
of the NDL Data Comm handler (RJE/NDLDCH). The mix-index used with .AUDIT refers to the mix-index 
number of the SDL Data Comm handler (RJE/DCH). 
The format of .AUDIT and .IOLOG are as follows: 


<mix-index >AX.AUDIT 


<mix-index >A XIOLOG 
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.RE or .READ 


This command directs the input/output program to open a card file named RJE/CARDS and begin reading 
the remote deck that is to be transmitted to the central system. RJE/CARDS is closed after the entire 
remote deck has been read. 


<mix-index>AX.READ 


.CL or .CLOS 


The .CL or .CLOS commands may be used to close all output files that were opened by the input/output 
program. The output of the central system is a continuous stream of data, and if it is directed to a backup 
disk or tape, it is sometimes desirable to divide the data into a set of logical backup files. These commands 
are useful for that function. 


<mix-index )AX.CLOS 


.CLCP 


The .CLCP command will close the card punch file. 


<mix-index>AX.CLCP 


-.CLLP 


The .CLLP command will close the line printer. 


<mix-index»AX.CLLP 


.oT or .STOP 


The .ST or STOP command terminates the current RJE session. A message is sent from the input/output 
program to the Data Comm handler RJE/DCH instructing it to cease all activity and to terminate itself. All 


queued messages are lost. 


<mix-index>AX.STOP 
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.WT or WAIT 


The .WT or .WAIT command instructs the Data Comm handler program to cease all line activity and wait to 
answer a call from the central system. The Data Comm handler issues a test command for a ringing phone. 
When control returns to the Data Comm handler indicating the phone is ringing, the Data Comm handler 
answers the phone and indicates so by the following message displayed on the console printer: 


PHONE RINGING 


A bell will ring at the remote system when the PHONE RINGING message is displayed. At that point, the 
Data Comm handler attempts to re-establish the line connection with the central system. 


The .WT or .WAIT command is used in conjunction with the RJE/DCH program only. 


<mix-index>AX.WAIT 


-EST 


The .EST command causes the Data Comm handler program to attempt to re-establish the line connection 
with the central system. The message ONLINE is displayed when the line connection is re-established. 


The .EST command may be used in conjunction with the retry function of RJE. The error message 
RETRIES-UP is displayed by the Data Comm handler program when the current buffer being sent to the 
central system is not being received. 


<mix-index>AX.EST 
.LOG 
The .LOG command is used to display on the console printer a summary of the line exceptions that have 
occurred during transmission. The operator can obtain an indication of the quality of the line connection 


and the rate of error activity on the line from the message or messages displayed. Each .LOG command 
entry resets the counters to zero. 


<mix-index>AX.LOG 


The format of the summary messages follows: 
nnnnnnnn NAKS SENT BECAUSE OF PARITY ERRORS 
nnnnnnnn IMPLIED NAKS SENT BECAUSE OF NO BUFFERS 
nnnnnnnn TIMEOUTS IN READ OPERATIONS 


nnnnnnnn TIMEOUTS IN WRITE OPERATIONS 
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nnnnnnnn OTHER EXCEPTIONS IN READ OPERATIONS 
nonnnnnn OTHER EXCEPTIONS IN WRITE OPERATIONS 
QS 
The .QS command instructs the Data Comm handler and the input/output program to maintain only the 


specified number of buffers in their queue files. The integer can be from 1 to 9999 and specifies the 
maximum number of messages that can be in the queue. 


<mix-index >A X.QS=integer 


Console Printer Messages 
The following five groups of messages contain all of the messages that can be displayed on the console 
printer during a RJE session. Some of these messages require operator intervention and some are used only 
to notify the operator of certain conditions. Some of the messages are common to several system software 
programs, and the other messages are used only with RJE/MCS or RJE/DCH. 
RJE/IO AND RJE/MCS COMMON CONSOLE PRINTER MESSAGES 
ERROR: “QS” OPERAND INVALID 
The integer exceeds four characters. 
ERRORS: INVALID CHARACTER DETECTED, RECORD SKIPPED 
An exception condition occurred on a card reader. The card image will also be displayed. 
ERROR: INVALID OPERATOR IN “.” INSTRUCTION, RE-ENTER 
An invalid local command was entered. 
ERROR: NO “=” IN *.QS” INSTRUCTION 
The ‘‘=”’ character is required in the “.QS” command. 
INPUT FILE EOF | 
The end of file was detected by the input device. 


REQUEST IGNORED, CARD FILE STILL OPEN 


Only one input file can be open at any one time. Wait for console printer message ‘INPUT FILE 
EOF’”’ before entering “‘.RE”’ or ““.READ”’. 


RJE/MCS UNIQUE CONSOLE PRINTER MESSAGE 
LOG FEATURE NOT IMPLEMENTED IN RJE/NDL 


Used with the RJE/NDLDCH Data Comm handler, and indicates that the log function is not 
implemented. 
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RJE/DCH AND RJE/NDLDCH COMMON CONSOLE PRINTER MESSAGES 
HOST ESTABLISHING 
Indicates that the central system detected the remote system first. 
LOSS OF DATA.SET.READY 
Indicates that the data set went ‘“‘down”’ during the last I/O sequence. If this occurs and switched 
lines are in use, the Data Comm handler will disconnect (if a connection had been established). 
The user must dial the central computer system again to establish the connection. 
ONLINE 
This message indicates that the remote system detected the central computer system first. 
RJE/DCH UNIQUE CONSOLE PRINTER MESSAGES 
“DLE-EOT” RECEIVED 
Signifies that the central computer is going off-line. If leased lines are in use, the Data Comm 
handler goes into the establishment phase until the central computer comes on-line again. If 
switched lines are in use, the Data Comm handler will wait for data set ready to occur and go 
into the establishment phase again. 
“WAIT” IGNORED ADAPTER NOT SWITCHED 
The .WAIT command was issued on a leased line. 


ERROR: CONTROL NOT PRESENT 


I/O complete was not received within 14 seconds on the specified I/O control. When this occurs, 
both RJE/DCH and RJE/IO goes to end of job. 


ERROR: INVALID ADAPTER TYPE 


The ID address from the specified adapter is not valid. RJE/DCH and RJE/IO goes to end of job 
when this occurs. 


ESTABLISHMENT RETRYS UP 
After 50 attempts by the remote system to establish communications with the central computer, 
this message is displayed. RJE/DCH then continues to try to make a connection with the central 
computer. 


FILE “DC/AUDIT.FILE” LOCKED 


Indicates that the audit file is already in use by another Data Comm handler. Modify the audit 
file to a different label and re-enter the .AUDIT command. 


INVALID RESPONSE 
The entry for the port, channel, or adapter was not numeric. 
LOSS OF CLEAR TO SEND 


The clear to send signal supplied by the data set was “‘lost’’ during an I/O operation. This is a 
recoverable error condition. The data set should be checked. 
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MEMORY PARITY ERROR 


A memory parity error occurred while attempting to send a message to the central computer. 
This is a recoverable error. 


PHONE RINGING 


The central computer is dialing the B 1700 remote system to attempt to re-establish 
communication. 


RJE/NDLDCH UNIQUE CONSOLE PRINTER MESSAGE 
RETRIES-UP 


Indicates that the current buffer being sent to the central computer system is not being 
acknowledged, due to the central computer not acknowledging the message, or because of 
transmission line problems that cause exception conditions whenever the message is transmitted 
after the retry limit has been reached. The RJE/NDLDCH program initiates the display of the 
RETRIES-UP message, and then requeues the current buffer. If a buffer is queued for another 
station, RJE/NDLDCH attempts to transmit that buffer; otherwise, RJE/NDLDCH continues, 
trying to transmit the same buffer. Should an “.EST”’ message be received at this time, then the 
message being retransmitted is discarded before the link is re-established. 
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